pySitools2_1.0

Description

pySitools2_1.0 is a generic python Sitools2V1.0 client

pySitools2 tool has been designed by IAS to perform all operations available within Sitools2.

The code defines several classes of Sitools2: Field, Query, Dataset and Project.

Building pySitools2_1.0

Getting the sources

$ git clone https://github.com/SITools2/pySitools2_1.0.git pySitools2_1.0

    The retrieved module structure is the following:
        LICENCE
        README.md
        setup.py
        -- sitools2
            -- clients
                README_GAIA.txt
                README_MEDIA.txt
                gaia_client_idoc.py // idoc client using pySitools2.py
                sdo_client_idoc.py // sdo client using pySitools2.py
            -- core
                pySitools2.py // SITools2 library core
                query.py
                utility.py
        -- examples
            example_gaia.py
            example_media.py
        -- tests
            testGaia.py
            testMedia.py
            testSitools2Core.py

Testing the module

$ cd pySitools2_1.0/src
    python setup.py test -q

Installing the module

Installing the module for the system

    $ cd pySitools2_1.0
sudo python setup.py install

Installing the module for the user

    $ cd pySitools2_1.0
python setup.py install --user

Features

• Defines several classes of Sitools2: Field, Query, Dataset and Project
• Make a search providing a date range, a wavelength, a cadence.
• Filter the results with specific keyword values (e.g. filter on quality, cdelt...)
• Download the results of your search.

Examples of application

sdo_client_idoc.py

This python module will allow you to :

- Make a request using the search() function.

    $ d1=datetime(2012,11,21,0,0,0)
    d2=d1+timedelta(days=1)
    sdo_data_list = search ( DATES=[d1,d2],WAVES=['335'],CADENCE=['6 h'] )

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

    $ get (MEDIA_DATA_LIST=sdo_data_list,TARGET_DIR='results')

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

    $ for item in sdo_data_list:
        my_meta_search = item.metadata_search ( KEYWORDS=['quality','cdelt1','cdelt2'] )
        print my_meta_search

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

    $ for item in sdo_data_list:
        my_meta_search = item.metadata_search ( KEYWORDS=['date__obs','quality','cdelt1','crval1'] )
        if (my_meta_search['quality'] == 0) :
            item.get_file( TARGET_DIR='results/' )

gaia_client_idoc.py

This python module will allow you to :

- Make a request using the search() function.

    $ d1=datetime( 2012,11,21,0,0,0 )
    d2=d1+timedelta( days=1 )
    gaia_data_list = search( DATES=[d1,d2] )

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

    $ get( GAIA_LIST=gaia_data_list,TARGET_DIR='results' )

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

    $ get( GAIA_LIST=gaia_data_list, TARGET_DIR="results", TYPE=['temp','em'] )