This shows you the differences between two versions of the page.
Both sides previous revision Previous revision Next revision | Previous revision Next revision Both sides next revision | ||
data:data_analysis_manual [2022/03/31 23:46] Peter Young [Flare lines] |
data:data_analysis_manual [2022/08/27 10:45] eric buchlin [Find data] Releases, SOAR TAP and sunpy-soar, pre-analysis |
||
---|---|---|---|
Line 11: | Line 11: | ||
SPICE papers: | SPICE papers: | ||
* Instrument paper: //Astron. Astrophys.//, **642**, A14, 2020. [[https://doi.org/10.1051/0004-6361/201935574|DOI]], [[https://ui.adsabs.harvard.edu/abs/2020A%26A...642A..14S|ADS]] | * Instrument paper: //Astron. Astrophys.//, **642**, A14, 2020. [[https://doi.org/10.1051/0004-6361/201935574|DOI]], [[https://ui.adsabs.harvard.edu/abs/2020A%26A...642A..14S|ADS]] | ||
- | * First results: Submitted | + | * First results: //Astron. Astrophys.//, **656**, A38, 2021. [[https://doi.org/10.1051/0004-6361/202141221|DOI]], [[https://ui.adsabs.harvard.edu/abs/2021A%26A...656A..38F/abstract|ADS]] |
* In-flight calibration: Not available yet | * In-flight calibration: Not available yet | ||
* Other papers can be found in the [[https://ui.adsabs.harvard.edu/public-libraries/rIi8Zx4zTg2stP5nTojx2Q|SPICE ADS library]] | * Other papers can be found in the [[https://ui.adsabs.harvard.edu/public-libraries/rIi8Zx4zTg2stP5nTojx2Q|SPICE ADS library]] | ||
Line 27: | Line 27: | ||
The full SPICE data set (to be cited in papers) has a DOI: [[https://doi.org/10.5270/esa-lbmdy7c|doi:10.5270/esa-lbmdy7c]]. DOIs will also be attributed to each data release. | The full SPICE data set (to be cited in papers) has a DOI: [[https://doi.org/10.5270/esa-lbmdy7c|doi:10.5270/esa-lbmdy7c]]. DOIs will also be attributed to each data release. | ||
+ | |||
+ | When browsing the SPICE catalog and archive you will see the following codes: | ||
+ | |||
+ | **n-ras**: a raster scan with one of the narrow slits (2", 4" or 6")\\ | ||
+ | **w-ras**: a raster scan with the wide slit (30")\\ | ||
+ | **n-sit**: a sit-and-stare study with one of the narrow slits\\ | ||
+ | **w-sit**: a sit-and-stare study with the wide slit\\ | ||
+ | **n-exp**: a single exposure with a narrow slit that yields the entire spectrum\\ | ||
+ | **w-exp**: a single exposure with the wide slit that yields the entire spectrum | ||
+ | |||
+ | For the "ras" data, the FITS file contains a single raster scan. If the raster is repeated, then each repeat goes in a new file. | ||
+ | |||
+ | Rasters can be performed in the "exp" mode, but each exposure will end up in a different FITS file. | ||
===== Find data ===== | ===== Find data ===== | ||
Line 34: | Line 47: | ||
- Run SPICE\_GEN\_CAT. The catalogue file will be written to the data tree root directory (you need to have write access) | - Run SPICE\_GEN\_CAT. The catalogue file will be written to the data tree root directory (you need to have write access) | ||
- Run SPICE\_CAT | - Run SPICE\_CAT | ||
- | * The catalogue file generated from all SPICE files is accessible [[http://astro-sdc-db.uio.no/vol/spice/fits/spice_catalog.txt|through the UiO website]] (restricted to SPICE team) | + | * The catalogue file generated from all SPICE files is accessible [[http://astro-sdc-db.uio.no/vol/spice/fits/spice_catalog.csv|through the UiO website]] (restricted to SPICE team) |
* How to use it in [[data:data_analysis_manual:read_catalog_python|Python]] | * How to use it in [[data:data_analysis_manual:read_catalog_python|Python]] | ||
- | * A CSV export of the part of the catalogue corresponding to each release is provided with the release. | + | * How to use it in IDL: [[data:data_analysis_manual#the_spice_catalog|see below]] |
+ | * A CSV export of the part of the catalogue corresponding to each release is provided with the data releases. | ||
+ | |||
+ | Data releases: | ||
+ | |||
+ | * All L1+ files with their latest versions (at a given date) are collected in a data release | ||
+ | * The releases are provided under https://spice.osups.universite-paris-saclay.fr/spice-data/ | ||
+ | * The latest release is updated with new data as they arrive (and after a superficial validation step). | ||
+ | * Each release includes release notes, and a CSV catalog of the files in the release. | ||
+ | * The SPICE data used in a publication have to be cited properly. How to do this is explained in the release notes. | ||
- | SOAR (and institute mirrors): | + | SOAR: |
* [[https://soar.esac.esa.int/|SOAR]] ([[https://issues.cosmos.esa.int/solarorbiterwiki/display/SOSP/SOAR+(Solar+Orbiter+Archive)+-+How+to+Use|how to use it]]) | * [[https://soar.esac.esa.int/|SOAR]] ([[https://issues.cosmos.esa.int/solarorbiterwiki/display/SOSP/SOAR+(Solar+Orbiter+Archive)+-+How+to+Use|how to use it]]) | ||
+ | * SOAR has a TAP interface that can be used for automated queries | ||
+ | * The ''sunpy-soar'' Python module uses this TAP interface for queries through SunPy/Fido | ||
+ | * Only queries by instrument / time / level / product [[https://github.com/sunpy/sunpy-soar/issues/46|at the moment]] | ||
Quicklooks: | Quicklooks: | ||
* Quicklook archive (to be developed) | * Quicklook archive (to be developed) | ||
* [[https://github.com/ITA-Solar/solo-spice-ql/wiki/spice_xfiles|Quicklooks in SSW]] | * [[https://github.com/ITA-Solar/solo-spice-ql/wiki/spice_xfiles|Quicklooks in SSW]] | ||
+ | * [[https://git.ias.u-psud.fr/spice/pre-analysis/|Pre-analysis]] (per STP) | ||
- | In the future: VSO. VSO through SSW or sunpy. Sunpy/Fido | + | VSO: |
+ | * (in the near future) | ||
+ | * Accessible through IDL/SSW and Python/Fido | ||
===== Tips and Advice on Analyzing SPICE Data ===== | ===== Tips and Advice on Analyzing SPICE Data ===== | ||
Line 148: | Line 176: | ||
| d->get\_number\_windows() | No. of spectral windows | | | d->get\_number\_windows() | No. of spectral windows | | ||
| d->get\_window\_data(i,/load) | Extract a data window | | | d->get\_window\_data(i,/load) | Extract a data window | | ||
+ | | d->get\_lambda\_vector(i) | Get wavelength vector for the window | | ||
| d->get\_header(i) | Extract a data window header | | | d->get\_header(i) | Extract a data window header | | ||
| d->get\_window\_id(i) | Get the data window ID | | | d->get\_window\_id(i) | Get the data window ID | | ||
Line 175: | Line 204: | ||
Use a 3-button mouse to browse the images and spectra: the middle button allows you to select a new pixel, the left button zooms in and the right button zooms out. | Use a 3-button mouse to browse the images and spectra: the middle button allows you to select a new pixel, the left button zooms in and the right button zooms out. | ||
+ | |||
+ | |||
+ | ===== Ephemeris information ===== | ||
+ | |||
+ | You can access ephemeris information from the SPICE headers. For example, the keywords: | ||
+ | |||
+ | DSUN\_AU - distance of the spacecraft from the Sun in AU\\ | ||
+ | EAR\_TDEL - light travel time from the spacecraft to Earth (seconds) | ||
+ | |||
+ | The full list of keywords is given in the [[https://spice.ias.u-psud.fr/spice-data/documents/SPICE-UIO-DPDD-0002-1.4-Data_Product_Description_Document.pdf|DPDD]] - search for "Solar ephemeris keywords". | ||
+ | |||
+ | Users should make sure to correct the SPICE observing times for EAR\_TDEL in order to compare with observations from Earth-orbiting spacecraft. This is especially important for highly-dynamic structures such as flares or CMEs. | ||
+ | |||
===== Read and display data (Python) ===== | ===== Read and display data (Python) ===== |