- General information for usage (see "configuration" item) scial2toh5 extract an arbitrary measurement data set (MDS) from a PDS file, calculates the geolocation for the dataset integration time and export the MDS plus the associated geolocation as a HDF5 file Usage: scial2toh5 [options] --ds dataset pds_file options: -h, --help display help -o string output file name --ds string dataset name -d, --directory string output directory -q, --query query which measurement data sets are present in PDS product -v version and dependency information - Examples: If you are interested in a dataset "DATASET" that is included in a level 2 file "SCIAL2FILE.N1" scial2toh5 --ds DATASET SCIAL2FILE.N1 creates a file SCIAL2FILE_DATASET.h5 that contains the extracted DATASET including the correct geolocation associated to this dataset. You can explicitely give the directory and the output file: scial2toh5 -o OUTFILE -d OUTDIRECTORY --ds DATASET SCIAL2FILE.N1 If you do not remember the names of the datasets included in SCIAL2FILE.N1, type scial2toh5 -q DATASET SCIAL2FILE.N1 for query. scial2toh5 is written in python. It has been only tested for SCIA L2 products. However, since reading and dataset extraction is done by help of CODA software included in BEAT (Basic ENVISAT atmospheric toolbox), that support a wide range of other atmospheric instruments like GOME (ERS-2), OMI, TES, MLS, and HIRDLS (Aura), GOME-2 and IASI (MetOp), OSIRIS (ODIN), and FTS (ACE), it could be easily extended for other products. - Dependencies: * numpy - Numerical Python support Download from distribution repositories or from official website: http://www.scipy.org/Download * BEAT - The basic ENVISAT atmospheric toolbox Download the newest version at http://www.stcorp.nl/beat/ (versions 6.2.0 and 6.3.0 successfully tested) Read the installation documentation and do not forget to configure enabling the python and the hdf support: ./configure --enable-python --with-hdf5 Eventually, you should also need to set the python-related include variables: export PYTHON_INCLUDE=$PYTHON_PREFIX/include/pythonX.Y export NUMPY_INCLUDE=$PYTHON_PREFIX/lib/pythonX.Y/site-packages/numpy/core/include where PYTHON_PREFIX refers to installation root and X.Y to python version. Change it to fit your requirements. Note: Do not forget to set the coda definitions enviroment varibles: In c-shell: setenv CODA_DEFINITION "$BEAT_PREFIX/share/beat/definitions" In bash: export CODA_DEFINITION="$BEAT_PREFIX/share/beat/definitions" Check installation: python import coda * PyTables - package for managing hierarchical datasets (HDF5 support) Download from repositories if available or from official website: http://www.pytables.org/moin/Downloads Check installation: python import tables - Configuration: if you include the "coda definitions enviroment" in your shell init file: In .cshrc (c-shell): setenv CODA_DEFINITION "$BEAT_PREFIX/share/beat/definitions", or in .bashrc (bash): export CODA_DEFINITION="$BEAT_PREFIX/share/beat/definitions", you can use the tool as mentioned above. Otherwise, you will need to add the python command to run the script: python scial2toh5 [options] --ds dataset pds_file where "python" should be the python version that has CODA and PyTables support.