Carnegie Supernova Project (CSP)¶
The csp
module provides access to data from the Carnegie Supernova
Project (CSP). It includes data from the first (DR1) and third (DR3) data
releases.
Data Release | Class Name | Data Type | Publication |
---|---|---|---|
Data Release 1 | DR1 | Spectroscopic | Folatelli et al. 2013 |
Data Release 3 | DR3 | Photometric | Krisciunas et al. 2017 |
Data Release 1¶
-
class
sndata.csp.
DR1
[source]¶ The
DR1
class provides access to spectra from the first release of optical spectroscopic data of low-redshift Type Ia supernovae (SNe Ia) by the Carnegie Supernova Project. It includes 604 previously unpublished spectra of 93 SNe Ia. The observations cover a range of phases from 12 days before to over 150 days after the time of B-band maximum light. (Source: Folatelli et al. 2013)Important
The DR1 spectra are both published and returned by sndata in units of rest frame wavelength.
- Deviations from the standard UI:
- None
- Cuts on returned data:
- None
-
delete_module_data
()¶ Delete any data for the current survey / data release
-
download_module_data
(force: bool = False, timeout: float = 15)¶ Download data for the current survey / data release
Parameters: - force – Re-Download locally available data
- timeout – Seconds before timeout for individual files/archives
-
get_available_ids
() → List[str]¶ Return a list of target object IDs for the current survey
Returns: A list of object IDs as strings
-
get_available_tables
() → List[Union[int, str]]¶ Get Ids for available vizier tables published by this data release
-
get_data_for_id
(obj_id: str, format_table: bool = True) → astropy.table.table.Table¶ Returns data for a given object ID
See
get_available_ids()
for a list of available ID values.Parameters: - obj_id – The ID of the desired object
- format_table – Format data into the
sndata
standard format
Returns: An astropy table of data for the given ID
-
iter_data
(verbose: bool = False, format_table: bool = True, filter_func: bool = None) → astropy.table.table.Table¶ Iterate through all available targets and yield data tables
An optional progress bar can be formatted by passing a dictionary of
tqdm
arguments. Outputs can be optionally filtered by passing a functionfilter_func
that accepts a data table and returns a boolean.Parameters: - verbose – Optionally display progress bar while iterating
- format_table – Format data for
SNCosmo
(Default: True) - filter_func – An optional function to filter outputs by
Yields: Astropy tables
-
load_table
(table_id: Union[int, str]) → astropy.table.table.Table¶ Return a Vizier table published by this data release
Parameters: table_id – The published table number or table name
Data Release 3¶
-
class
sndata.csp.
DR3
[source]¶ The
DR3
class provides access to data from the third data release of the Carnegie Supernova Project (CSP) which includes natural-system optical (ugriBV) and near-infrared (YJH) photometry of 134 supernovae (SNe) that were observed in 2004-2009 as part of the first stage of the Carnegie Supernova Project (CSP-I). The sample consists of 123 Type Ia SNe, 5 Type Iax SNe, 2 super-Chandrasekhar SN candidates, 2 Type Ia SNe interacting with circumstellar matter, and 2 SN 2006bt-like events. The redshifts of the objects range from z=0.0037 to 0.0835; the median redshift is 0.0241. For 120 (90%) of these SNe, near-infrared photometry was obtained. (Source: Krisciunas et al. 2017)- Deviations from the standard UI:
- None
- Cuts on returned data:
- None
-
delete_module_data
()¶ Delete any data for the current survey / data release
-
download_module_data
(force: bool = False, timeout: float = 15)¶ Download data for the current survey / data release
Parameters: - force – Re-Download locally available data
- timeout – Seconds before timeout for individual files/archives
-
get_available_ids
() → List[str]¶ Return a list of target object IDs for the current survey
Returns: A list of object IDs as strings
-
get_available_tables
() → List[Union[int, str]]¶ Get Ids for available vizier tables published by this data release
-
get_data_for_id
(obj_id: str, format_table: bool = True) → astropy.table.table.Table¶ Returns data for a given object ID
See
get_available_ids()
for a list of available ID values.Parameters: - obj_id – The ID of the desired object
- format_table – Format data into the
sndata
standard format
Returns: An astropy table of data for the given ID
-
classmethod
get_zp_for_band
(band: str) → str¶ Get the zeropoint for a given band name
Parameters: band – The name of the bandpass
-
iter_data
(verbose: bool = False, format_table: bool = True, filter_func: bool = None) → astropy.table.table.Table¶ Iterate through all available targets and yield data tables
An optional progress bar can be formatted by passing a dictionary of
tqdm
arguments. Outputs can be optionally filtered by passing a functionfilter_func
that accepts a data table and returns a boolean.Parameters: - verbose – Optionally display progress bar while iterating
- format_table – Format data for
SNCosmo
(Default: True) - filter_func – An optional function to filter outputs by
Yields: Astropy tables
-
load_table
(table_id: Union[int, str]) → astropy.table.table.Table¶ Return a Vizier table published by this data release
Parameters: table_id – The published table number or table name
-
register_filters
(force: bool = False)¶ Register filters for this survey / data release with SNCosmo
Parameters: force – Re-register a band if already registered