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
DR1class 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() → None¶ 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[str, int]]¶ 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
sndatastandard 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
tqdmarguments. Outputs can be optionally filtered by passing a functionfilter_functhat 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
DR3class 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() → None¶ 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[str, int]]¶ 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
sndatastandard 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
tqdmarguments. Outputs can be optionally filtered by passing a functionfilter_functhat 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