Ignore:
Timestamp:
Nov 14, 2020, 3:27:44 PM (4 years ago)
Author:
emillour
Message:

Mars GCM:

  • Make a single README file (get rid of REAME.exec) and update "compile" script to (hopefully) better illustrate how to compile utilities
  • Update utilities zrecast and lslin: zrecast.F90: Force the vertical interpolation of any variable starting by "rho" to be in log space (as it should for density, molecular concentration in mol.cm-3 etc..). Set missing value to 1.E20 lslin.F90: fix various problems in the output.

FF + EM

File:
1 moved

Legend:

Unmodified
Added
Removed
  • trunk/LMDZ.MARS/util/README

    r2431 r2432  
    1 This directory contains executable files (and their source) that can be
     1This directory contains source codes of utilities (programs) that can be
    22used to process the LMD Mars GCM output files (like "diagfi" or
    3 "stats"), whatever the dimension.
    4 In addition most output file from one of these program can be
    5 processes by another.
     3"stats").
     4In addition most output file from one of these program can then be
     5processed by another.
    66
    7 The executable files should run on any Linux platform.
     7See script "compile" for instructions and recommendations to compile
     8the utilities. Once adequately modified, that script can be used to
     9compile each utility; e.g. to build the zrecast.e utility program:
     10> compile zrecast
    811
    9 Inputs can be provided by (1) replying to questions on screen or
    10 (2) filling the corresponding  *.def and direct the input of these *.def
     12Note that inputs can be provided by (1) replying to questions on screen or
     13(2) filling the corresponding  *.def and redirecting the input of these *.def
    1114files instead. For example :
    1215> concatnc.e < concatnc.def
     
    1417
    1518--------------------------------------------------------------------
    16 1) concatnc.e
     191) concatnc.e : concatenate successive GCM output files
    1720--------------------------------------------------------------------
    1821
     
    2326software like Grads may not be able to use it. To have a linear "Ls"
    2427timescale, you can use "Ls_Linear.e" (see below).
     28You can also add a "Ls" variable corresponding solar longitude for each
     29timestep by using the "adls" option.
    2530
    2631Output file is : concat.nc
    2732
    28 MODIFICATION:
    29 07/2008 Utility concatnc.F90 (not used by the gcm): improvement in order
    30 to 1) concatenate 1D variable and 2) increase the number of input files
    31 up to 1000
    32 
    33 
    3433--------------------------------------------------------------------
    35 2) localtime.e
     342) zrecast.e : put GCM data in physical vertical coordinate
    3635--------------------------------------------------------------------
    3736
    38 Program to redistribute and interpolate the variable a the same
    39 local times everywhere (useful to mimic satellite observations, or
    40 analyse day to day variations at a given local time).
    41 input : diagfi.nc  / concat.nc / stats.nc kind of files
    42 
    43 output file is :
    44 name_of_input_file_LT.nc with pressure coordinate
    45 
    46 --------------------------------------------------------------------
    47 3) zrecast.e
    48 --------------------------------------------------------------------
     37GCM outputs are in GCM hybrid coordinate which do not correspond to any
     38physical vertical coordinate ! zrecast is NECESSARY to make any publishable
     39scientific figure.
    4940
    5041This program reads 4D (lon-lat-alt-time) fields from GCM output files
     
    6556- surface pressure
    6657- atmospheric temperature
    67 - hybrid coordinates aps() and bps(), or sigma levels() (see section
    68 1.3.2)
     58- hybrid coordinates aps() and bps(), or sigma levels()
    6959- ground geopotential (in input file; if not found, it is sought
    7060  in a 'diagfi.nc' file. If not found there, it is then sought in
     
    77672.2 in source file)
    7868
     69- Vertical interpolation : note that density (kg.m-3) and species density
     70(e.g. in molecules.cm-3) must be vertically interpolated in log-space. For
     71that purpose, these variables names must start with "rho" (exemple : rho for
     72density, rho_co2, rho_o2, etc....)
     73
    7974output file is :
    8075name_of_input_file_P.nc with pressure coordinate
     
    8378name_of_input_file_R.nc with altitude as distance to center of planet
    8479
    85 MODIFICATION :
    86 01/2010 : correction to interpolate above surface if density is not available.
    87 03/2011 : added possibility to have output as distance to center of planet
     80--------------------------------------------------------------------
     813) localtime.e : put GCM data in local time coordinate
     82--------------------------------------------------------------------
     83
     84Program to redistribute and interpolate the variable a the same
     85local times everywhere (useful to mimic satellite observations, or
     86analyse day to day variations at a given local time).
     87input : diagfi.nc  / concat.nc / stats.nc kind of files
     88
     89output file is : name_of_input_file_LT.nc
    8890
    8991--------------------------------------------------------------------
    90 4) lslin.e
     924) lslin.e : redistribute and AVERAGE gcm output in Ls coordinate.
    9193--------------------------------------------------------------------
    9294
    9395This program has been designed to interpol data in Solar Longitude (Ls)
    9496linear time coordinate (usable with grads) from Netcdf diagfi or concatnc 
    95 files.
    96 output file is : lslin.nc
    97 lslin also create a lslin.ctl file that can be read
     97files and to AVERAGE the instantaneous data in Ls period (for comparison with
     98binned dataset, for instance).
     99
     100lslin also creates a lslin.ctl file that can be read
    98101directly by grads (>xdfopen lsllin.ctl) to plot in Ls coordinate to
    99102avoid some problem with grads when grads think that "the time interval
    100103is too small"...
    101104
    102 MODIFICATION
    103 10/2007 Utility lslin.F90 (not used by the gcm)
    104 changed evaluation of 'start_var' from hard-coded values to a computed value
    105 04/2015 Added possibility to bin data (instead of interpolating) over
    106 the time intervals
     105Output file is : name_of_input_file_LS.nc
    107106
    108107--------------------------------------------------------------------
    109 5) hrecast.e
     1085) solzenangle.e : select GCM data at a given solar zenith angle
    110109--------------------------------------------------------------------
    111110
    112 This program can interpolate GCM output on any horizontal grid (regular lat - lon) as long as it cover all the
    113 planet. The grid can be given points by points. The best way is to use the redirected input hrecast.def
     111Program to redistribute and interpolate the variable a the same
     112solar zenith angle (notably useful to mimic satellite observations and in particular
     113SOLAR OCCULTATIONS by choosing solar zenith angle = 90°)
     114The user choose between Morning and Evening side.
     115
     116input : diagfi.nc  / concat.nc / stats.nc kind of files
     117
     118On the morning side output file (1 output per sol per grid point) is :
     119 name_of_input_file_MO.nc 
     120
     121On the evening side output file is (1 output per sol per grid point):
     122 name_of_input_file_EV.nc 
     123
     124--------------------------------------------------------------------
     1256) hrecast.e : interpolate data at another horizontal grid resolution.
     126--------------------------------------------------------------------
     127
     128This program can interpolate GCM output on any horizontal grid (regular
     129lat - lon) as long as it cover all the planet.
     130The grid can be given points by points. The best way is to use the
     131redirected input hrecast.def
    114132
    115133hrecast.e < hrecast.def
     
    117135
    118136--------------------------------------------------------------------
    119 6) expandstartfi.e
     1377) expandstartfi.e : to plot data in a startfi.nc file
    120138--------------------------------------------------------------------
    121139
     140In startfi.nc file, data are not plotable because the horizontal coordinate
     141in only a 1D list of all atmospheric columns on the planets.
    122142This program takes a physics start file ("startfi.nc") and recasts it
    123143on the corresponding  lonxlat grid (so it contents may easily be displayed
    124 using Grads, Ferret, etc.)
     144using Python, Grads, Ferret, etc.)
    125145
    126146Simply run expandstartfi.e as a command line with arguments:
     
    132152
    133153--------------------------------------------------------------------
    134 6) extract.e
     1548) extract.e : get data at specific coordinates for comparison with observations
    135155--------------------------------------------------------------------
    136156
Note: See TracChangeset for help on using the changeset viewer.