Skip to content

Commit 09fca7e

Browse files
committed
IRSA-7363 Document spherex SIA delay
1 parent abbf4b2 commit 09fca7e

File tree

2 files changed

+13
-0
lines changed

2 files changed

+13
-0
lines changed

tutorials/spherex/spherex_cutouts.md

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -83,6 +83,7 @@ bandpass = 'SPHEREx-D2'
8383
output_filename = 'spherex_cutouts_mef.fits'
8484
```
8585

86+
(spherex-query-tap)=
8687
## 5. Query IRSA for a list of cutouts that satisfy the criteria specified above.
8788

8889
Here we show how to use the `pyvo` TAP SQL query to retrieve all images that overlap with the position defined above.
@@ -117,6 +118,11 @@ print("Time to do TAP query: {:2.2f} seconds.".format(time.time() - t1))
117118
print("Number of images found: {}".format(len(results)))
118119
```
119120

121+
:::{note}
122+
SPHEREx data are also available via SIA which can provide a simpler interface for many queries, as demonstrated in {ref}`spherex-query-sia`.
123+
An advantage of the method shown above is that it provides access to data immediately after ingestion (which occurs weekly) and is not subject to the same ~1 day delay as SIA.
124+
:::
125+
120126
## 6. Define a function that processes a list of SPHEREx Spectral Image Cutouts
121127

122128
This function takes in a row of the catalog that we created above and does the following:

tutorials/spherex/spherex_intro.md

Lines changed: 7 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -65,6 +65,7 @@ from astroquery.ipac.irsa import Irsa
6565
from firefly_client import FireflyClient
6666
```
6767

68+
(spherex-query-sia)=
6869
## 5. Search for SPHEREx Spectral Image MEFs that overlap coordinates you are interested in
6970

7071
+++
@@ -102,6 +103,12 @@ There are currently three collections available for the second Quick Release:
102103
results = Irsa.query_sia(pos=(coord, search_radius), collection='spherex_qr2')
103104
```
104105

106+
:::{note}
107+
SPHEREx data are ingested on a weekly basis.
108+
Due to the nature of the ingestion process, availability via SIA will lag on the order of a day.
109+
To avoid this delay, users can access data through the browsable directories or the SPHEREx Data Explorer GUI (see [SPHEREx Data Access](https://caltech-ipac.github.io/spherex-archive-documentation/spherex-data-access)), or do a TAP query as shown in {ref}`spherex-query-tap`.
110+
:::
111+
105112
Each row of the results of your query represents a different spectral image.
106113
Because SPHEREx data will be released on a weekly basis, the number of rows returned will change
107114
depending on when you submit the query.

0 commit comments

Comments
 (0)