urls_hek#

iris.data.urls_hek(time_start=None, time_stop=None, description='', obs_id=None, limit=200, nrt=False, spectrograph=True, sji=True, deconvolved=False, num_retry=5)[source]#

Find a list of URLs to download matching the given parameters.

Parameters:

  • time_start (None | Time) – The start time of the search period. If None, the start of operations, 2013-07-20 will be used.

  • time_stop (None | Time) – The end time of the search period. If None, the current time will be used.

  • description (str) – The description of the observation. If an empty string, observations with any description will be returned.

  • obs_id (None | int) – the OBSID of the observation, a number which describes the size, cadence, etc. of the observation. If None, all OBSIDs will be used.

  • limit (int) – The maximum number of observations returned by the query. Note that this is not the same as the number of files since there are several files per observation.

  • spectrograph (bool) – Boolean flag controlling whether to include spectrograph data.

  • sji (bool) – Boolean flag controlling whether to include SJI data.

  • deconvolved (bool) – Boolean flag controlling whether to include the deconvolved slitjaw imagery. Has no effect if sji is False.

  • num_retry (int) – The number of times to try to connect to the server.

  • nrt (bool) – Whether to return results with near-real-time (NRT) data.

Return type:

list[str]

Examples

Find the URLs of the last 5 “A1: QS monitoring” spectrograph observations in 2023.

import astropy.time
import iris

iris.data.urls_hek(
    time_start=astropy.time.Time("2023-01-01T00:00"),
    time_stop=astropy.time.Time("2024-01-01T00:00"),
    description="A1: QS monitoring",
    limit=5,
    sji=False,
)

['https://www.lmsal.com/solarsoft/irisa/data/level2_compressed/2023/12/29/20231229_111732_3882010194/iris_l2_20231229_111732_3882010194_raster.tar.gz',
 'https://www.lmsal.com/solarsoft/irisa/data/level2_compressed/2023/12/28/20231228_043002_3882010194/iris_l2_20231228_043002_3882010194_raster.tar.gz',
 'https://www.lmsal.com/solarsoft/irisa/data/level2_compressed/2023/12/23/20231223_074521_3882010194/iris_l2_20231223_074521_3882010194_raster.tar.gz',
 'https://www.lmsal.com/solarsoft/irisa/data/level2_compressed/2023/12/31/20231231_070352_3882010194/iris_l2_20231231_070352_3882010194_raster.tar.gz',
 'https://www.lmsal.com/solarsoft/irisa/data/level2_compressed/2023/12/27/20231227_041001_3882010194/iris_l2_20231227_041001_3882010194_raster.tar.gz']