Difference between revisions of "AEROCOM-idltools"
Line 49: | Line 49: | ||
Basically there are three ways to use the AEROCOM-idltools: | Basically there are three ways to use the AEROCOM-idltools: | ||
* Change the main program | * Change the main program | ||
+ | :the most commonly changed settings will be the variables: | ||
+ | : c_Models | ||
+ | : c_ModelYears | ||
+ | : c_ModelDataType | ||
+ | : c_ModelVars | ||
+ | : c_ObsNetworkYear | ||
+ | : c_ObsNetworkDataType | ||
+ | |||
+ | :Please look at source code of aerocom_main.pro for examples and help with possible values. | ||
+ | |||
* Use include files | * Use include files | ||
− | :In general the AEROCOM-idltools are looking for an include file named <code>IDL_includetemp.pro</code>. If it exists, it is included, if not, the settings from the main program <code>aerocom_main.pro</code> are used. | + | :In general the AEROCOM-idltools are looking for an include file named <code>IDL_includetemp.pro</code>. If it exists, it is included, if not, the settings from the main program <code>aerocom_main.pro</code> are used. Usually one will use <code>IDL_includetemp.pro</code> as a link to point to the 'real' include file.<br> |
− | |||
:Please note that due to limitations of idl you will see an error message, if the file <code>IDL_includetemp.pro</code> does not exist at compile time. The tools will run anyway. | :Please note that due to limitations of idl you will see an error message, if the file <code>IDL_includetemp.pro</code> does not exist at compile time. The tools will run anyway. | ||
* Batch usage | * Batch usage | ||
− | :For batch usage one has to define the environment variable <code>AEROCOMWORKDIR</code> to the | + | :For batch usage one has to define the environment variable <code>AEROCOMWORKDIR</code> to the absolute path name of the <code>aerocomIDL</code> directory. |
− |
Revision as of 10:03, January 7, 2010
Description of the AEROCOM-idltools
Purpose
Rapid data analysis to perform
- Analysis of Model 2d fields
- Model vs. ground data comparisons
- Model vs. model comparisons
- Model vs. satellite data comparisons
Features
- Read model data of 50+ models/experiments
- Daily, monthly, 3hrly data
- Calculate daily or monthly data, if necessary
- Do the same plots for several models at once
- Variables are fully configurable
- Filter data (e.g. location, height, land, sea, etc.)
- Read obs data (e.g. AERONET, EBAS, AEROCE, EMEP, EARLINET, etc.)
- Read satellite data (MISR, MODIS)
- Extract model data at ground station locations
- Plot model 2d fields
- Plot time series of model vs. ground data
- Plot model vs. model data at ground station locations
- Scatter plots, Taylor plots, Histograms
- Calculation of Median model and write it to netCDF files
- Interpolate data to common grid
- Calculation of climatological obs data set
- Several statistics (Scores)
- Can be run as a batch job
- Distributed to the idefix2 users via svn repository
Requirements
Usually users will use the AEROCOM-idltools on the AEROCOM server idefix2.extra.cea.fr where it is also tested.
In principle the tools can be used on every unix machine that runs idl 7.1.1. (which is the first version to be able to read netCDF version 4 files) and has necessary resources (RAM and storage) to store the wanted model data. By rule of thumb the tools need ca. 1GB for a model with an 1 by 1 degree grid.
There are also some rules for the format of the netcdf files. Please send questions regarding this to Michael Schulz or Jan Griesfeller
Getting the tools
On idefix2 you can download the repository with the command
svn checkout file:///home/aerocom0/AAATOOLS/SVN/aerocomIDL
This will create the subfolder aerocomIDL in the current folder.
Setting up idl to run the AEROCOM-idltools
There are some constraints regarding the idl configuration to run the AEROCOM-idltools. You have to make sure the the actual working directory is set to the directory of the tools (named aerocomIDL above). In addition the search path of idl has to be setup to include the aerocomIDL directory and all the subdirectories. Since there are several ways to achieve this, please consult the idl documentation how to do this.
Use the tools
Basically there are three ways to use the AEROCOM-idltools:
- Change the main program
- the most commonly changed settings will be the variables:
- c_Models
- c_ModelYears
- c_ModelDataType
- c_ModelVars
- c_ObsNetworkYear
- c_ObsNetworkDataType
- Please look at source code of aerocom_main.pro for examples and help with possible values.
- Use include files
- In general the AEROCOM-idltools are looking for an include file named
IDL_includetemp.pro
. If it exists, it is included, if not, the settings from the main programaerocom_main.pro
are used. Usually one will useIDL_includetemp.pro
as a link to point to the 'real' include file. - Please note that due to limitations of idl you will see an error message, if the file
IDL_includetemp.pro
does not exist at compile time. The tools will run anyway.
- Batch usage
- For batch usage one has to define the environment variable
AEROCOMWORKDIR
to the absolute path name of theaerocomIDL
directory.