IDLSitools2_1.0

Access SDO data & GAIA-DEM data

Download .zip Download .tar.gz View on GitHub

Welcome to IDLSitools2_1.0 GitHub Pages.

IDLSitools2_1.0

Description

IDLSitools2_1.0 is a generic IDL Sitools2V1.0 client.

IDLSitools2 tool has been designed by MEDOC at IAS (Institut d'Astrophysique Spatiale) to perform all operations available within Sitools2 via IDL.

The IDLSitools2 routines allow you to interrogate the MEDIA & GAIA-DEM servers.

Building IDLSitools2_1.0

Installing the module

- Download the last archive file using the buttons above.

NB: Use the following command for a linux server :
     $ git clone https://github.com/MedocIAS/IDLSitools2_1.0.git IDLSitools2_1.0  (git required)

- Extract the archive into your favourite directory ex : ~/Sitools2Client, if needed.

- Add the install directory to your env var 'IDL_PATH'.

     $ export IDL_PATH=$IDL_PATH:+~/SitoolsClient/

Features

  • Make a search providing a date range, if needed a wavelength and a cadence.
  • Download the results of your search.

Examples of application :

MEDIA

This IDL module will allow you to :

- Make a request using the media_search() function.

    $ sdo_list=media_search( DATES=LIST('2011-01-01T00:00:00','2011-01-01T00:05:00') , WAVES=LIST('304','193') , CADENCE=LIST('1 min'),  NB_RES_MAX=10)

    for hmi data 

    $ sdo_list=media_search( DATES=LIST('2016-06-01T00:00:00','2016-06-02T01:00:00') , SERIE='hmi.m_720s_nrt' ,CADENCE=LIST('12 min'), NB_RES_MAX=10)

- Print the result :
    $ FOREACH result, sdo_list DO PRINT,  result->get_attributes()

- Simply download the result of your previous search() calling the media_get() function.

    $ media_execute=media_get(MEDIA_DATA_LIST=sdo_list)

- Have additional metadata information about each previous answer using the metadata_search() method.

    $ FOREACH sdo_item, sdo_list DO BEGIN
        meta_data_search=sdo_item->metadata_search(KEYWORDS=LIST('quality','cdelt1','cdelt2'))
        PRINT, JSON_SERIALIZE(meta_data_search)
      ENDFOREACH

or build a list of recnum and only make one request :

    $ recnum_list=LIST()
    $ FOREACH result, sdo_list DO recnum_list.Add, result->get_recnum() 
    $ meta_list=metadata_search(KEYWORDS=LIST('date__obs','quality','cdelt1','cdelt2'), RECNUM_LIST=recnum_list , SERVER_NAME='idoc-solar-portal-test.ias.u-psud.fr')

- Filter on a specific keyword before download data using the get_file() method.

$ FOREACH sdo_item, sdo_list DO BEGIN
    meta_data_search=sdo_item->metadata_search(KEYWORDS=LIST('quality','cdelt1','cdelt2'))
    file=obj_new()
    IF meta_data_search['quality'] EQ 0 THEN  file=sdo_item->get_file(TARGET_DIR='/tmp')
  ENDFOREACH

GAIA-DEM

This IDL module will allow you to :

- Make a request using the gaia_search() function.

    $ gaia_list=gaia_search( DATES=LIST('2011-01-01T00:00:00','2011-01-01T23:05:00'),  NB_RES_MAX=10)

- Simply download the result of your previous search() calling the gaia_get() function.

    $ gaia_execute=gaia_get( GAIA_LIST=gaia_list,TARGET_DIR='/tmp' )

- Specify the TYPE you want to retrieve , it should be a list among : 'temp','em','width','chi2'

    $ gaia_collect_em_files=gaia_get (GAIA_LIST=gaia_list,TYPE=LIST("em","temp"), target_dir="/tmp" )

- Download a tar ball file (slower) :
$ gaia_tar_collect=gaia_get (GAIA_LIST=gaia_list,DOWNLOAD_TYPE="tar", target_dir="/tmp" ,FILENAME="my_download_file.tar")

Requirements

This IDL module requires IDL 8.2 or above.