NAME

mom_to_wind_etl - compute winds from moments via the etl method.

SYNOPSIS

mom_to_wind_etl -s startdate -e enddate [-t smoothtime] [-T reporttime]

[-f firstheight] [-l lastheight] [-h smoothheight] [-H reportheight]

[-z filesize] [-m modes] [-i inputdir] [-o outputdir] [-r errorlimit]

[-q qclimit]

AVAILABLILTY

this program is in /net/sssf2/profiler/analysis/bin

DESCRIPTION

This program gets moment data between the startdate and enddate, smooths the data according to the options listed below, and computes winds which are written out in netcdf files. mom_to_wind_etl looks for the original moment netcdf files in the directory specified in the INPUT_DIR environmental variable, and writes the new wind netcdf files to the directory specified by the OUTPUT_DIR environmental variable. Files are only created for the time period in which data is found. The files are all hourly files.

 

OPTIONS

-s startdate

This is not an optional option. It must be provided. It gives the date and time to start collecting data from. It must be given in the following format: "yyyy-mm-dd hh:nn:ss" where yyyy=year, mm=month, dd=day, hh=hour, nn=minutes, ss=seconds.

 

-e enddate

This is not an optional option. It must be provided. It gives the date and time to stop collecting data. It must be given in the following format: "yyyy-mm-dd hh:nn:ss" where yyyy=year, mm=month, dd=day, hh=hour, nn=minutes, ss=seconds.

 

-t smoothtime

use the given time instead of the default (one hour) as the amount of time over which to smooth the data. This must be given in the format "hh:mm:ss" where hh=hours, mm=minutes, ss=seconds

 

-T reporttime

use the given time instead of the default (one hour) as the time interval at which to report each profile. It must be given in the format "hh:mm:ss" where hh=hours, mm=minutes, ss=seconds

 

-f firstheight

use the given height as the first height instead of the default (100 meters AGL). This must be given in meters AGL.

 

-l lastheight

use the given height as the last height instead of the default (6000 meters AGL). This must be given in meters AGL.

 

-h smoothheight

use the given height interval as the interval over which to smooth the data instead of the default (100 meters). This must be given as meters.

 

-H reportheight

use the given height interval as the interval at which to report the heights instead of the default (100 meters, i.e. there will be a data point every 100 meters). This must be given as meters.

 

-z filesize

the amount of time to put into each file. The default is 1 hour. This must be entered in the format: hh:mm:ss where hh=hour, mm=minutes, and ss=seconds (Example: -z "01:00:00"). CAUTION: This will only work if all the data is present at the time of writing the file. For example, if you want a daily file then the begintime and endtime must include the entire day.

 

-m modes

specifies which modes to use data from. This option requires that the user have some knowledge of the data - not only how many modes were run, but at exactly what pulse widths. For example, if the profiler was run in 2 modes of pulse widths 700 and 3300 and the user wants only the 700 modes the commaned would be: -m 700 if the user wants both: -m 700 3300. The default is to use all modes available in the input files.

 

-i inputdir

specifies the directory in which to find the .mom files to use for calculating winds. If this option is provided it is used. If not, the program looks for the environmental variable INPUT_DIR. If that is not found then it looks in the current working directory.

 

-o outputdir

specifies the directory in which to put the newly created .wnd files. If this option is provided it is used. If not, the program looks for the environmental variable OUTPUT_DIR. If that is not found then it puts the new files in the current working directory.

 

-r errorlimit

specify an error value above which all data will be flagged and no winds will be calculated. The default is to calculate all winds.

 

-q qclimit

specify a qc value above which all data will be flagged and no specify an error value above which all data will be flagged and no winds will be calculated. The default is to calculate all winds.

 

ENVIRONMENT

The INPUT_DIR and OUTPUT_DIR variables can be set.

FILES

Input moment netcdf files of the correct format must be found in the INPUT_DIR directory.

SEE ALSO

profiler_to_netcdf, spc_to_mom_hs, qc_mom_ww, procexample

NOTES

 

BUGS

There is currently no error checking. If the wrong format, or the input/output directories do not exist a core dump will occor.

 

IMPORTANT NOTE:

Right now, the functionality of being able to loop through different report and smooth intervals within the startdate to enddate interval is not functioning properly. You must have equal amounts of time in the startdate to enddate interval as in the smooth interval and the report interval must be equal or greater than the smooth interval as well. For example, for the defaults set in the program, the user can only set the startdate and enddate at one hour increments. To run half hour increments, the smoothheight and reportheight options would need to be changed as in the following example:

mom_to_wind_etl -s "1993-06-17 00:00:00" -e "1993-06-17 00:30:00"

-t "00:30:00" -T "00:30:00"

This will hopefully get fixed soon.