CDMSClass¶
- class astroquery.linelists.cdms.CDMSClass[source]¶
Bases:
BaseQuery
Attributes Summary
Methods Summary
get_species_table
(*[, catfile, use_cached, ...])A directory of the catalog is found in a file called 'catdir.cat.'
query_lines
(*args, **kwargs)Queries the service and returns a table object.
query_lines_async
(min_frequency, ...[, ...])Creates an HTTP POST request based on the desired parameters and returns a response.
Attributes Documentation
- TIMEOUT = 60¶
- URL = 'https://cdms.astro.uni-koeln.de/cgi-bin/cdmssearch'¶
Methods Documentation
- get_species_table(*, catfile='catdir.cat', use_cached=True, catfile_url='https://cdms.astro.uni-koeln.de/classic/entries/partition_function.html')[source]¶
A directory of the catalog is found in a file called ‘catdir.cat.’
The table is derived from https://cdms.astro.uni-koeln.de/classic/entries/partition_function.html
- Parameters:
- catfilestr, name of file, default ‘catdir.cat’
The catalog file, installed locally along with the package
- Returns:
- Table:
Table
- tag : The species tag or molecular identifier.molecule : An ASCII name for the species.#line : The number of lines in the catalog.lg(Q(n)) : A seven-element vector containing the base 10 logarithm of the partition function.
- Table:
- query_lines(*args, **kwargs)¶
Queries the service and returns a table object.
Creates an HTTP POST request based on the desired parameters and returns a response.
- Parameters:
- min_frequency
astropy.units.Quantity
or None Minimum frequency (or any spectral() equivalent).
None
can be interpreted as zero.- max_frequency
astropy.units.Quantity
or None Maximum frequency (or any spectral() equivalent).
None
can be interpreted as infinite.- min_strengthint, optional
Minimum strength in catalog units, the default is -500
- moleculelist, string of regex if parse_name_locally=True, optional
Identifiers of the molecules to search for. If this parameter is not provided the search will match any species. Default is ‘All’. As a first pass, the molecule will be searched for with a direct string match. If no string match is found, a regular expression match is attempted. Note that if the molecule name regex contains parentheses, they must be escaped. For example, ‘H2C(CN)2.*’ must be specified as ‘H2C(CN)2.*’ (but because of the first-attempt full-string matching, ‘H2C(CN)2’ will match that molecule successfully).
- temperature_for_intensityfloat
The temperature to use when computing the intensity Smu^2. Set to 300 by default for compatibility with JPL and the native catalog format, which defaults to 300. ** If temperature is set to zero, the return value in this column will be the Einstein A value **
- flagsint, optional
Regular expression flags. Default is set to 0
- parse_name_locallybool, optional
When set to True it allows the method to parse through catdir.cat (see
get_species_table
) in order to match the regex inputted in the molecule parameter and request the corresponding tags of the matches instead. Default is set to False- get_query_payloadbool, optional
When set to
True
the method should return the HTTP request parameters as a dict. Default value is set to False- cachebool
Defaults to True. If set overrides global caching behavior. See caching documentation.
- min_frequency
- Returns:
- tableA
Table
object.
- tableA
Examples
>>> table = CDMS.query_lines(min_frequency=100*u.GHz, ... max_frequency=110*u.GHz, ... min_strength=-500, ... molecule="018505 H2O+") >>> print(table) FREQ ERR LGINT DR ELO GUP TAG QNFMT Ju Ku vu Jl Kl vl F name MHz MHz MHz nm2 1 / cm ----------- ----- ------- --- -------- --- ----- ----- --- --- --- --- --- --- ----------- ---- 103614.4941 2.237 -4.1826 3 202.8941 8 18505 2356 4 1 4 4 0 4 3 2 1 3 0 3 H2O+ 107814.8763 148.6 -5.4438 3 878.1191 12 18505 2356 6 5 1 7 1 6 7 4 4 8 1 7 H2O+ 107822.3481 148.6 -5.3846 3 878.1178 14 18505 2356 6 5 1 7 1 7 7 4 4 8 1 8 H2O+ 107830.1216 148.6 -5.3256 3 878.1164 16 18505 2356 6 5 1 7 1 8 7 4 4 8 1 9 H2O+
- query_lines_async(min_frequency, max_frequency, *, min_strength=-500, molecule='All', temperature_for_intensity=300, flags=0, parse_name_locally=False, get_query_payload=False, cache=True)[source]¶
Creates an HTTP POST request based on the desired parameters and returns a response.
- Parameters:
- min_frequency
astropy.units.Quantity
or None Minimum frequency (or any spectral() equivalent).
None
can be interpreted as zero.- max_frequency
astropy.units.Quantity
or None Maximum frequency (or any spectral() equivalent).
None
can be interpreted as infinite.- min_strengthint, optional
Minimum strength in catalog units, the default is -500
- moleculelist, string of regex if parse_name_locally=True, optional
Identifiers of the molecules to search for. If this parameter is not provided the search will match any species. Default is ‘All’. As a first pass, the molecule will be searched for with a direct string match. If no string match is found, a regular expression match is attempted. Note that if the molecule name regex contains parentheses, they must be escaped. For example, ‘H2C(CN)2.*’ must be specified as ‘H2C(CN)2.*’ (but because of the first-attempt full-string matching, ‘H2C(CN)2’ will match that molecule successfully).
- temperature_for_intensityfloat
The temperature to use when computing the intensity Smu^2. Set to 300 by default for compatibility with JPL and the native catalog format, which defaults to 300. ** If temperature is set to zero, the return value in this column will be the Einstein A value **
- flagsint, optional
Regular expression flags. Default is set to 0
- parse_name_locallybool, optional
When set to True it allows the method to parse through catdir.cat (see
get_species_table
) in order to match the regex inputted in the molecule parameter and request the corresponding tags of the matches instead. Default is set to False- get_query_payloadbool, optional
When set to
True
the method should return the HTTP request parameters as a dict. Default value is set to False- cachebool
Defaults to True. If set overrides global caching behavior. See caching documentation.
- min_frequency
- Returns:
- response
requests.Response
The HTTP response returned from the service.
- response
Examples
>>> table = CDMS.query_lines(min_frequency=100*u.GHz, ... max_frequency=110*u.GHz, ... min_strength=-500, ... molecule="018505 H2O+") >>> print(table) FREQ ERR LGINT DR ELO GUP TAG QNFMT Ju Ku vu Jl Kl vl F name MHz MHz MHz nm2 1 / cm ----------- ----- ------- --- -------- --- ----- ----- --- --- --- --- --- --- ----------- ---- 103614.4941 2.237 -4.1826 3 202.8941 8 18505 2356 4 1 4 4 0 4 3 2 1 3 0 3 H2O+ 107814.8763 148.6 -5.4438 3 878.1191 12 18505 2356 6 5 1 7 1 6 7 4 4 8 1 7 H2O+ 107822.3481 148.6 -5.3846 3 878.1178 14 18505 2356 6 5 1 7 1 7 7 4 4 8 1 8 H2O+ 107830.1216 148.6 -5.3256 3 878.1164 16 18505 2356 6 5 1 7 1 8 7 4 4 8 1 9 H2O+