cloudncplot
This program produces time-height quicklooks from netCDF cloud radar or netCDF lidar data. The program is invoked as
follows:
cloudncplot [options] file1.nc [file2.nc ...]
Options
- -png
- Produce PNG images. This is the default.
- -eps, -ps
- Produce encapsulated postscript images. These files can be
incorporated into documents or sent directly to a postscript printer.
- -onefield
- Plot only the first field from each file.
- -oneplot
- Produce only one plot and send it to standard output rather than a
file.
- -prefix s
- Put the images in the directory s.
- -xfs s
- Contact the X font server s. By default the
program tries to contact unix/:7100, but this is not always
the appropriate port to use; under RedHat Linux 6.0 you should use
`-xfs unix/:-1'. If X is running then you can find the
address of the font server by running `xset -q'. In XFree86
version 4.0 the font server has been incorporated with the X server,
so an X font server needs to be run independently: as root run
`xfs -port 7100'. Unfortunately at present there are no
fall-back fonts built into the program.
- -heightrange f1 f2
- Set the height range to be from f1 km to
f2 km.
- -range f1 f2
- Set the range of whatever parameter to be from f1
to f2. Note that lidar backscatter coefficient is
plotted on a logarithmic scale, and in this case the range is
10f1 to 10f2 (sr m)-1, and the
default values are -7 and -4.
- -hourrange f1 f2
- Plot data from f1 UTC to f2
UTC. By default a whole day is plotted. See also the
-duration option.
- -duration f
- Only plot the first f hours in the file. If
f is negative then the last -f
hours are plotted; this is useful for real-time applications where the
most recent data is required.
- -rayduration f
- Assume that each ray is f hours in duration when
plotting each ray. The default is 0.01 hours (36 seconds).
- -size {width}x{height}
- Set the size of the axes in pixels.
- -barsize {width}x{height}
- Set the size of the colourbar in pixels.
- -fontsize n
- Set the size of the font (default 12).
- -system s
- Override the default name of the instrument; this string is
written at the bottom left of each plot. Note that the string can
contain certain HTML tags such as I, B, SUB, SUP, and also SYM for
greek letters.
- -field s
- Override the default name of the field being plotted; this string
is written on the y-axis of the colourbar.
- -units s
- Override the default units of the field being plotted; this string
is written on the y-axis of the colourbar in parentheses after the
name of the field.
- -id s
- Short code to use in filenames to indicate the instrument. For
radars I tend to use the radar frequency in GHz and the string
`lc' for the lidar ceilometer.
- -palette filename
- Read an RGB colourmap from a file and use it in rendering the
images. The format of the file is simple; whitespace-separated ascii
integers between 0 to 255 which are interpreted as consecutive RGB
triplets. The default built-in jet colourmap has 64 entries and
looks like this:
223 223 223
209 209 227
195 195 232
181 181 236
168 168 241
154 154 245
140 140 250
127 127 255
111 111 255
95 95 255
79 79 255
63 63 255
47 47 255
31 31 255
15 15 255
0 0 255
0 19 243
0 39 231
0 59 219
0 79 207
0 99 195
0 119 183
0 139 171
0 159 159
0 171 139
0 183 119
0 195 99
0 207 79
0 219 59
0 231 39
0 243 19
0 255 0
31 255 0
63 255 0
95 255 0
127 255 0
159 255 0
191 255 0
223 255 0
255 255 0
255 239 0
255 223 0
255 207 0
255 191 0
255 175 0
255 159 0
255 143 0
255 127 0
255 111 0
255 95 0
255 79 0
255 63 0
255 47 0
255 31 0
255 15 0
255 0 0
239 0 15
223 0 31
207 0 47
191 0 63
175 0 79
159 0 95
143 0 111
127 0 127