Personal tools

Difference between revisions of "WOAnetcdfTOhdf5"

From MohidWiki

Jump to: navigation, search
Line 1: Line 1:
Software that converts the netcdf files of the World Ocean Atlas 2005 (WOA05) into HDF5, it allows to create HDF5 files for Mohid using the Module LIFE (mmol/m3) or the Module WaterQuality (mg/l)
+
Software that converts the netcdf files of the World Ocean Atlas 2005 (WOA05) into HDF5, it allows to create HDF5 files for Mohid using the Module LIFE (mmol/m3) or the Module WaterQuality (mg/l). The user will be prompted when the software is ran.
 +
 
 +
Running options for this application are specified by the user in a input file named PARAMETER_READ.dat.
 +
 
 +
==Input file (PARAMETER_READ.dat)==
 +
ACTION            : CONVERT LEVITUS FORMAT
 +
INPUT_FILENAME    : ... (path/name of NetCDF file to be converted)
 +
OUTPUT_FILENAME  : ... (path/name of HDF5 file to be converted)
 +
 +
JUST_REPORT      : 0/1 (1 = obtain to file only input file header info, 0 = default)
 +
CONVERT_TO_ASCII  : 0/1 (1 = convert data to ASCII format, 0 = default)
 +
CONVERT_TO_HDF5  : 0/1 (1 = convert data to HDF5 format, 0 = default)
 +
 +
XX_VARIABLE      : ... (name of longitude variable in the input file: usual name is "lon") 
 +
YY_VARIABLE      : ... (name of latitude variable in the input file: usual name is "lat")
 +
TIME_VARIABLE    : ... (name of time variable in the input file: usual name is "time")
 +
 
 +
''Remarks''
 +
- if JUST_REPORT : 1 no HDF5 file will be produced regardless of the choice in CONVERT_TO_HDF5;
 +
- CONVERT_TO_ASCII : 1 should not usually be attempted because ASCII file can be potentially
 +
  very large; its main use is for the application development and debugging;
 +
- if CONVERT_TO_HDF5 : 0 or if this keyword is inexistent in the input file no HDF5 file will
 +
  be created;
 +
- the names in XX_VARIABLE, YY_VARIABLE and TIME_VARIABLE are expected to be the same for
 +
  different NOAA reanalysis NetCDF files, i.e. "lon", "lat" and "time".
 +
 
 +
==Samples==
 +
<begin_file>
 +
ACTION                  : CONVERT LEVITUS FORMAT
 +
 
 +
OUTPUTFILENAME          : WOA05_climatology.hdf5
 +
OUTPUT_GRID_FILENAME    : WOA05_Grid1.dat
 +
OUTPUT_GEOMETRY_FILENAME : WOA05_Geometry1.dat
 +
 
 +
<<begin_input_files>>
 +
t0112an1.nc
 +
s0112an1.nc
 +
n0112an1.nc
 +
i0112an1.nc
 +
p0112an1.nc
 +
o0112an1.nc
 +
<<end_input_files>>
 +
<end_file>
  
 
[[Category:Tools]]
 
[[Category:Tools]]
 
[[Category:Hdf5]]
 
[[Category:Hdf5]]

Revision as of 19:50, 10 May 2010

Software that converts the netcdf files of the World Ocean Atlas 2005 (WOA05) into HDF5, it allows to create HDF5 files for Mohid using the Module LIFE (mmol/m3) or the Module WaterQuality (mg/l). The user will be prompted when the software is ran.

Running options for this application are specified by the user in a input file named PARAMETER_READ.dat.

Input file (PARAMETER_READ.dat)

ACTION            : CONVERT LEVITUS FORMAT
INPUT_FILENAME    : ... (path/name of NetCDF file to be converted)
OUTPUT_FILENAME   : ... (path/name of HDF5 file to be converted)

JUST_REPORT       : 0/1 (1 = obtain to file only input file header info, 0 = default)
CONVERT_TO_ASCII  : 0/1 (1 = convert data to ASCII format, 0 = default)
CONVERT_TO_HDF5   : 0/1 (1 = convert data to HDF5 format, 0 = default)

XX_VARIABLE       : ... (name of longitude variable in the input file: usual name is "lon")  
YY_VARIABLE       : ... (name of latitude variable in the input file: usual name is "lat")
TIME_VARIABLE     : ... (name of time variable in the input file: usual name is "time")
Remarks
- if JUST_REPORT : 1 no HDF5 file will be produced regardless of the choice in CONVERT_TO_HDF5;
- CONVERT_TO_ASCII : 1 should not usually be attempted because ASCII file can be potentially
  very large; its main use is for the application development and debugging;
- if CONVERT_TO_HDF5 : 0 or if this keyword is inexistent in the input file no HDF5 file will
  be created;
- the names in XX_VARIABLE, YY_VARIABLE and TIME_VARIABLE are expected to be the same for
  different NOAA reanalysis NetCDF files, i.e. "lon", "lat" and "time".

Samples

<begin_file>
ACTION                   : CONVERT LEVITUS FORMAT
OUTPUTFILENAME           : WOA05_climatology.hdf5
OUTPUT_GRID_FILENAME     : WOA05_Grid1.dat
OUTPUT_GEOMETRY_FILENAME : WOA05_Geometry1.dat
<<begin_input_files>>
t0112an1.nc
s0112an1.nc
n0112an1.nc
i0112an1.nc
p0112an1.nc
o0112an1.nc
<<end_input_files>>
<end_file>