|
|
Line 1: |
Line 1: |
| ==Description of the AEROCOM-idltools== | | ==Description of the AEROCOM-idltools== |
| + | [[Brief description]] |
| | | |
− | === Purpose ===
| + | [[FAQ]] |
− | Rapid data analysis to perform
| |
− | * Analysis of Model 2d fields
| |
− | * Model vs. ground data comparisons
| |
− | * Model vs. model comparisons
| |
− | * Model vs. satellite data comparisons
| |
| | | |
− | The LSCE is using the tools to provide all the plots on the AEROCOM web interface at http://nansen.ipsl.jussieu.fr/AEROCOM/database.html
| + | [[Howtos]] |
− | | |
− | An example plot is below:<br>[[image:OD550_AER_an2000_mALLYEAR_WORLD_MAP.ps.png]]
| |
− | | |
− | === 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.<br>
| |
− | 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.<br>
| |
− | There are also some rules for the format of the netcdf files. Please send questions regarding this to [mailto:Michael.Schulz@lsce.ipsl.fr Michael Schulz] or [mailto:jan.griesfeller@lsce.ipsl.fr Jan Griesfeller]
| |
− | | |
− | ===Getting the tools===
| |
− | On idefix2 you can download the repository with the command<br>
| |
− | <code>svn checkout file:///home/aerocom0/AAATOOLS/SVN/aerocomIDL</code><br>
| |
− | This will create the subfolder <tt>aerocomIDL</tt> 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 <tt>aerocomIDL</tt> above). In addition the search path of idl has to be setup to
| |
− | include the <tt>aerocomIDL</tt> directory and all the subdirectories. Since there are several ways to achieve this, please consult the idl documentation how to do this.
| |
− | | |
− | In addition you are advised to copy the file <code>aerocom_include.pro</code> to <code>~/.idl/aerocom</code>
| |
− | and adjust the setting of the variable <code>c_BaseDir</code> to your needs. Inside of this directory you will then find the directory plots with the plots created by the AEROCOM-idltools.
| |
− | | |
− | Please note that the later described include files are included '''after''' the file <code>~/.idl/aerocom/aerocom_include.pro</code> is included and may therefore alter some of the settings again.
| |
− | | |
− | ===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 <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.
| |
− | * Batch usage
| |
− | :For batch usage one has to define the environment variable <code>AEROCOMWORKDIR</code> to the absolute path name of the <code>aerocomIDL</code> directory. The slash (/) at the end is mandantory. One can then use the script <code>StartBatchParam.job</code> to start the AEROCOM-idltools with an include file as first parameter (e.g. <code>StartBatchParam.job ./include/aerocom/OD550_2000_Aerocom.pro</code>). This batch job can also be used for a batching system like qsub.
| |
− | | |
− | ===Update the tools===
| |
− | Since our group releases frequent updates of the AEROCOM-idltools it might be useful to update the tools from time to time. One can do that by running the command in the folder <code>aerocomIDL</code>:<br>
| |
− | <code>svn update</code>
| |