1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
|
.. _astroquery.esa.integral:
**********************************************************************
ESA Integral Science Legacy Archive (ISLA) (`astroquery.esa.integral`)
**********************************************************************
INTEGRAL is the INTernational Gamma-Ray Astrophysics Laboratory of the
European Space Agency. It observes the Universe in the X-ray and soft
gamma-ray band. Since its launch, on October 17, 2002, the ISDC receives
the spacecraft telemetry within seconds and provides alerts, processed
data and analysis software to the worldwide scientific community.
========
Examples
========
---------------------------
1. ADQL Queries to ISLA TAP
---------------------------
The Query TAP functionality facilitates the execution of custom Table Access Protocol (TAP)
queries within the Integral Science Legacy Archive. Results can be exported to a specified
file in the chosen format, and queries may be executed asynchronously.
.. doctest-remote-data::
>>> from astroquery.esa.integral import IntegralClass
>>> isla = IntegralClass()
>>> isla.query_tap(query='select * from ivoa.obscore') # doctest: +IGNORE_OUTPUT
<Table length=6743>
access_estsize access_format access_url calib_level ... t_max t_min t_resolution t_xel
int64 object object int32 ... float64 float64 float64 int64
-------------- ----------------- ------------------------------------------------------------------------------ ----------- ... ----------- ----------- ------------ -----
26923 application/x-tar https://isla.esac.esa.int/tap/data?retrieval_type=SCW&b2JzaWQ9MDA2MDAwMjAwMDE= 2 ... 52594.80985 52593.47308 6.1e-05 1
488697 application/x-tar https://isla.esac.esa.int/tap/data?retrieval_type=SCW&b2JzaWQ9MDA2MDAwNDAwMDE= 2 ... 52596.64583 52596.46613 6.1e-05 1
3459831 application/x-tar https://isla.esac.esa.int/tap/data?retrieval_type=SCW&b2JzaWQ9MDA2MDAwNjAwMDI= 2 ... 52600.54167 52599.4592 6.1e-05 1
... ... ... ... ... ... ... ... ...
351253 application/x-tar https://isla.esac.esa.int/tap/data?retrieval_type=SCW&b2JzaWQ9ODg4MDExMzAwMDQ= 2 ... 57188.63542 57188.28125 6.1e-05 1
10195 application/x-tar https://isla.esac.esa.int/tap/data?retrieval_type=SCW&b2JzaWQ9ODg4MDExMzAwMDU= 2 ... 57189.64284 57189.28867 6.1e-05 1
817730 application/x-tar https://isla.esac.esa.int/tap/data?retrieval_type=SCW&b2JzaWQ9ODg5OTgwMTAzMDE= 2 ... 52636.82597 52636.49534 6.1e-05 1
------------------
2. Getting sources
------------------
Users can utilize this method to retrieve a target from the Archive by specifying a target name.
The output can be formatted and saved as needed.
.. doctest-remote-data::
>>> from astroquery.esa.integral import IntegralClass
>>> isla = IntegralClass()
>>> isla.get_sources(target_name='crab')
<Table length=1>
name ra dec source_id
object float64 float64 object
------ ----------------- ----------------- ----------------
Crab 83.63320922851562 22.01447105407715 J053432.0+220052
-----------------------------------------
3. Getting metadata associated to sources
-----------------------------------------
By invoking this method, users gain access to detailed metadata for a given source,
identified by its target name. The metadata provides in-depth information about the source's archival.
.. doctest-remote-data::
>>> from astroquery.esa.integral import IntegralClass
>>> isla = IntegralClass()
>>> metadata = isla.get_source_metadata(target_name='Crab')
>>> metadata # doctest: +IGNORE_OUTPUT
[{'name': 'Integral', 'link': None, 'metadata': [{'param': 'Name', 'value': 'Crab'}, {'param': 'Id', 'value': 'J053432.0+220052'}, {'param': 'Coordinates degrees', 'value': '83.6324 22.0174'}, {'param': 'Coordinates', 'value': '05 34 31.78 22 01 02.64'}, {'param': 'Galactic', 'value': '184.55 -5.78'}, {'param': 'Isgri flag2', 'value': 'very bright source'}, {'param': 'Jemx flag', 'value': 'detected'}, {'param': 'Spi flag', 'value': 'detected'}, {'param': 'Picsit flag', 'value': 'detected'}]}, {'name': 'Simbad', 'link': 'https://simbad.cds.unistra.fr/simbad/sim-id?Ident=Crab', 'metadata': [{'param': 'Id', 'value': 'NAME Crab'}, {'param': 'Type', 'value': 'SuperNova Remnant'}, {'param': 'Other types', 'value': 'HII|IR|Psr|Rad|SNR|X|gam'}]}]
------------------------------------
4. Retrieving observations from ISLA
------------------------------------
Observation data can be extracted using this method, defining a criteria such as target name,
coordinates, search radius, time range, or revolution number range.
The data can be formatted and saved to a file, with the option to perform the
operation asynchronously.
.. doctest-remote-data::
>>> from astroquery.esa.integral import IntegralClass
>>> isla = IntegralClass()
>>> isla.get_observations(target_name='crab', radius=12.0, start_revno='0290', end_revno='0599') # doctest: +IGNORE_OUTPUT
<Table length=27>
dec email end_revno endtime ... starttime surname title
float64 str60 object object ... object str20 str120
---------- ------------------------------ --------- ------------------- ... ------------------- ---------- --------------------------------------------------------------
26.3157778 peter.kretschmar!@obs.unige.ch 0352 2005-09-02 21:20:59 ... 2005-08-31 11:07:06 Kretschmar Target of Opportunity Observations of an Outburst in A 0535+26
22.684 isdc-iswt@unige.ch 0300 2005-03-30 22:42:38 ... 2005-03-30 10:34:41 ISWT Crab spring/05 IBIS 10 deg arc
20.611 isdc-iswt@unige.ch 0300 2005-03-31 13:35:11 ... 2005-03-30 22:44:07 ISWT Crab spring/05 IBIS 10 deg arc
... ... ... ... ... ... ... ...
22.0144444 inthelp@sciops.esa.int 0541 2007-03-21 00:08:52 ... 2007-03-20 21:30:30 Public Crab-2007 Spring: JEM-X VC settings test
22.0144444 inthelp@sciops.esa.int 0541 2007-03-22 03:16:24 ... 2007-03-21 00:10:22 Public Crab-2007 Spring: IBIS on-axis staring
22.0144444 inthelp@sciops.esa.int 0541 2007-03-20 15:35:22 ... 2007-03-19 12:53:21 Public Crab-2007 Spring: SPI 5x5 pattern
------------------------------
5. Downloading Science Windows
------------------------------
Science window data can be downloaded using this method by providing only one identifier,
such as science window IDs, observation ID, revolution number, or proposal ID.
An additional parameter, read_fits (default value True) reads automatically the downloaded FITS files.
* If ``read_fits=True``, a list of objects containing filename, path and the FITS file opened is returned.
* If ``read_fits=False``, the file name and path where the file has been downloaded is provided.
.. doctest-remote-data::
>>> from astroquery.esa.integral import IntegralClass
>>> isla = IntegralClass()
>>> results = isla.download_science_windows(science_windows=['008100430010', '033400230030'], output_file=None) # doctest: +IGNORE_OUTPUT
---------------------
6. Timeline retrieval
---------------------
This method enables the exploration of the observation timeline for a specific region in the sky.
Users can provide right ascension (RA) and declination (Dec) coordinates and adjust the radius
to refine their search.
.. doctest-remote-data::
>>> from astroquery.esa.integral import IntegralClass
>>> from astropy.coordinates import SkyCoord
>>> isla = IntegralClass()
>>> coordinates = SkyCoord(83.63320922851562, 22.01447105407715, unit="deg")
>>> timeline = isla.get_timeline(coordinates=coordinates)
>>> timeline # doctest: +IGNORE_OUTPUT
{'total_items': 8714, 'fraFC': 0.8510442965343126, 'totEffExpo': 16416293.994214607, 'timeline': <Table length=8714>
scwExpo scwRevs scwTimes scwOffAxis
float64 float64 object float64
------------------ ------------------ -------------------------- ---------------------
5147.824025240096 39.07800595179441 2003-02-07 07:01:25.500000 0.0025430719729003476
4212.920636876789 39.09690979681126 2003-02-07 08:21:21.500000 0.0025430719729003476
4212.920651101999 39.11392562227784 2003-02-07 09:33:18.500000 0.0025430719729003476
... ... ... ...
1675.7455103834102 2767.3106645083526 2024-04-17 13:39:13.500000 4.729406754053243
1815.2853971426027 2767.31963717696 2024-04-17 14:13:35.500000 4.203559877974954
2014.34083657953 2767.3294779577823 2024-04-17 14:51:17 4.731196416616404}
--------------------
7. Retrieving epochs
--------------------
A list of observation epochs can be retrieved using this method, focusing on periods when data for a
specific target, instrument, or energy band is available.
.. doctest-remote-data::
>>> from astroquery.esa.integral import IntegralClass
>>> isla = IntegralClass()
>>> isla.get_epochs(target_name='J011705.1-732636', band='28_40')
<Table length=50>
epoch
object
----------------
0152_01200360001
0745_06340000001
0746_06340000001
...
1618_12200430006
1618_12200430009
1618_12200430011
This will perform an ADQL search to the Integral database and will return the output.
----------------
8. Data Download
----------------
For each of the following features, an additional parameter, read_fits, is available.
* If ``read_fits=True``, a list of objects containing filename, path and the FITS file opened is returned.
* If ``read_fits=False``, the file names and paths where the files have been downloaded is provided.
8.1. Retrieving Long-Term Timeseries
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
This method provides access to long-term timeseries data for a specified target.
Users can refine their results by selecting an instrument or energy band.
.. doctest-remote-data::
>>> from astroquery.esa.integral import IntegralClass
>>> isla = IntegralClass()
>>> ltt = isla.get_long_term_timeseries(target_name='J174537.0-290107', instrument='jem-x') # doctest: +IGNORE_OUTPUT
8.2. Retrieving Short-Term Timeseries
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
This method allows for the download of short-term time series data for a target and epoch of interest.
Users can refine their search using instrument or energy band filters and
the results are saved to a file for detailed examination.
.. doctest-remote-data::
>>> from astroquery.esa.integral import IntegralClass
>>> isla = IntegralClass()
>>> stt = isla.get_short_term_timeseries(target_name='J011705.1-732636', band='28_40', epoch='0745_06340000001') # doctest: +IGNORE_OUTPUT
8.3. Retrieving spectra
~~~~~~~~~~~~~~~~~~~~~~~
This method allows users to download spectral data for a target and epoch.
Users can apply filters, such as instrument or energy band, and save the results to an
output file for further processing.
.. doctest-remote-data::
>>> from astroquery.esa.integral import IntegralClass
>>> isla = IntegralClass()
>>> spectra = isla.get_spectra(target_name='J011705.1-732636', instrument='ibis', epoch='0745_06340000001') # doctest: +IGNORE_OUTPUT
8.4. Retrieving mosaics
~~~~~~~~~~~~~~~~~~~~~~~
Mosaic images corresponding to a specified epoch can be downloaded using this method.
Users can filter by instrument or energy band and save the resulting image to a file for later use.
.. doctest-remote-data::
>>> from astroquery.esa.integral import IntegralClass
>>> isla = IntegralClass()
>>> mosaics = isla.get_mosaic(epoch='0727_88601650001', instrument='ibis') # doctest: +IGNORE_OUTPUT +IGNORE_WARNINGS
Reference/API
=============
.. automodapi:: astroquery.esa.integral
:no-inheritance-diagram:
|
