Differences

This shows you the differences between two versions of the page.

--- data:data_analysis_manual [2022/03/31 23:35]
Peter Young [Find data]
+++ 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:
   * 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
   * 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.
+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 =====
@@ 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\_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]]
-  * 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]])
+  * 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:
   * Quicklook archive (to be developed)
   * [[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 =====
@@ Line 59: / Line 87: @@
 ==== Flare lines ====
+The two key flare lines for EIS are Fe XVIII 974.86 and Fe XX 721.56 that are formed around 7 MK and 10 MK, respectively. The Fe XVIII line will probably be seen in active region cores (at least from bright active regions).
+The Fe XVIII line is located between the stronger H I 972.54 (Lyman-gamma) and C III 977.02, but measurements should be possible.
+The Fe XX line lies close to Fe VIII 721.26. One can estimate the strength of this line by comparing with Mg IX 706.06. The latter will be about a factor 10 stronger.
+To determine if a flare is occurring at the time of a SPICE observation, check the STIX Data Browser at:
+[[https://datacenter.stix.i4ds.net/view/plot/lightcurves
+]]
 ===== Access data =====
@@ Line 138: / Line 176: @@
 | d->get\_number\_windows()      | No. of spectral windows                |
 | 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\_window\_id(i)          | Get the data window ID                 |
@@ Line 165: / 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.
+===== 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) =====

User Tools

Site Tools

Differences

Page Tools