queryLinkedEarth (pyleoclim.utils.lipdutils.queryLinkedEarth)

pyleoclim.utils.lipdutils.queryLinkedEarth(archiveType=[], proxyObsType=[], infVarType=[], sensorGenus=[], sensorSpecies=[], interpName=[], interpDetail=[], ageUnits=[], ageBound=[], ageBoundType=[], recordLength=[], resolution=[], lat=[], lon=[], alt=[], print_response=True, download_lipd=True, download_folder='default')[source]

This function allows to query the LinkedEarth wiki for records.

This function allows to query the LinkedEarth wiki for specific catagories. If you have more than one keyword per catagory, enter them in a list. If you don’t wish to use a particular terms, leave a blank in-between the brackets.

Parameters

  • archiveType (list of strings) – The type of archive (enter all query terms, separated by a comma)

  • proxyObsType (list of strings) – The type of proxy observation (enter all query terms, separated by a comma)

  • infVarType (list of strings) – The type of inferred variable (enter all query terms, separated by a comma)

  • sensorGenus (list of strings) – The Genus of the sensor (enter all query terms, separated by a comma)

  • sensorSpecies (list of strings) – The Species of the sensor (enter all query terms, separated by a comma)

  • interpName (list of strings) – The name of the interpretation (enter all query terms, separated by a comma)

  • interpDetail (list of strings) – The detail of the interpretation (enter all query terms, separated by a comma)

  • ageUnits (list of strings) – The units of in which the age (year) is expressed in. Warning: Separate each query if need to run across multiple age queries (i.e., yr B.P. vs kyr B.P.). If the units are different but the meaning is the same (e.g., yr B.P. vs yr BP, enter all search terms separated by a comma).

  • ageBound (list of floats) – Enter the minimum and maximum age value to search for. Warning: You MUST enter a minimum AND maximum value. If you wish to perform a query such as “all ages before 2000 A.D.”, enter a minimum value of -99999 to cover all bases.

  • ageBoundType (list of strings) – The type of querying to perform. Possible values include: “any”, “entire”, and “entirely”. - any: Overlap any portions of matching datasets (default) - entirely: are entirely overlapped by matching datasets - entire: overlap entire matching datasets but dataset can be shorter than the bounds

  • recordLength (list of floats) – The minimum length the record needs to have while matching the ageBound criteria. For instance, “look for all records between 3000 and 6000 year BP with a record length of at least 1500 year”.

  • resolution (list of floats) – The maximum resolution of the resord. Resolution has the same units as age/year. For instance, “look for all records with a resolution of at least 100 years”. Warning: Resolution applies to specific variables rather than an entire dataset. Imagine the case where some measurements are made every cm while others are made every 5cm. If you require a specific variable to have the needed resolution, make sure that either the proxyObservationType, inferredVariableType, and/or Interpretation fields are completed.

  • lat (list of floats) – The minimum and maximum latitude. South is expressed with negative numbers. Warning: You MUST enter a minimum AND maximum value. If you wish to perform a query looking for records from the Northern Hemisphere, enter [0,90].

  • lon (list of floats) – The minimum and maximum longitude. West is expressed with negative numbers. Warning: You MUST enter a minimum AND a maximum value. If you wish to perform a query looking for records from the Western Hemisphere, enter [-180,0].

  • alt (list of floats) – The minimum and maximum altitude. Depth below sea level is expressed as negative numbers. Warning: You MUST enter a minimum AND a maximum value. If you wish to perform a query looking for records below a certain depth (e.g., 500), enter [-99999,-500].

  • print_response (bool) – If True, prints the URLs to the matching LiPD files

  • download_lipd (bool) – If True, download the matching LiPD files

  • download_folder (string) – Location to download the LiPD files. If “default”, will download in the current directory.

Returns

res

Return type

the response to the query