def plot_ncdf_output(id, datafn, **kwds):
"""Plot model field id from the data in netCDF file datafn.
Positional Input Parameter:
* id: Name of the id of the field to plot. String.
* datafn: Filename containing the output data to plot. String.
Input keyword parameter descriptions are found in the docstring
for Qtcm methods ploti, plotm, and other methods that call this
private method. In general, those methods take the keyword
parameters they receive and pass it along unchanged as keyword
parameters to this function. In that sense, this function is
seldom used as a stand-alone function, but rather is usually
used coupled with a Qtcm instance.
The data fields read in from the netCDF output file are dimensioned
(time, lat, lon). This is different than how the data is stored
in the compiled QTCM model fields (lon, lat, time), and at the
Python level (lon, lat). The reason this is the case is that
f2py automatically makes the arrays passed between the Python
and Fortran levels match.
For a lat vs. lon plot, the contour plot is superimposed onto
a cylindrical projection map of the Earth with continents drawn
and labeled meridians and parallels. The title also includes
the model time, and x- and y-axis labels are not drawn.
All numerical data used for plotting come from the netCDF output
file for consistency (e.g., the dimensions of u1). Currently
this method only works for 3-D data arrays (two in space, one
in time).
"""
#- Accomodate other ids. The id that this routine will use
# (i.e., iduse corresponds to the name in the netCDF output file)
# is called iduse. Set this to id, except for the case where
# some aliases of ids are entered in which iduse is the alias:
if id == 'Qc': iduse = 'Prec'
elif id == 'FLWut': iduse = 'OLR'
elif id == 'STYPE': iduse = 'stype'
else: iduse = id
#- Set defined keyword defaults. All are set to None except for
# nlatlon which gets an integer:
plotkwds_ids = [
'lat', 'lon', 'time', 'fn', 'levels', 'title', 'xlabel', 'ylabel',
'filled', 'nlatlon', 'tmppreview'
]
plotkwds = {}
for ikey in plotkwds_ids:
if kwds.has_key(ikey):
plotkwds[ikey] = copy.copy(kwds[ikey])
else:
plotkwds[ikey] = None
if not kwds.has_key('nlatlon'):
plotkwds['nlatlon'] = 8
#- Get data and dimensions of iduse to plot:
fileobj = S.NetCDFFile(datafn, mode='r')
data = N.array(fileobj.variables[iduse].getValue())
data_name = fileobj.variables[iduse].long_name
data_units = fileobj.variables[iduse].units
dim = {}
dimname = {}
dimunits = {}
dim['lat'] = N.array(fileobj.variables['lat'].getValue())
dimname['lat'] = fileobj.variables['lat'].long_name
dimunits['lat'] = fileobj.variables['lat'].units
dim['lon'] = N.array(fileobj.variables['lon'].getValue())
dimname['lon'] = fileobj.variables['lon'].long_name
dimunits['lon'] = fileobj.variables['lon'].units
dim['time'] = N.array(fileobj.variables['time'].getValue())
dimname['time'] = fileobj.variables['time'].long_name
dimunits['time'] = fileobj.variables['time'].units
fileobj.close()
#- Alter data long name to remove any units. The definition
# of units as the substring within the [] is the same as used in
# defVar in output.F90 of the compiled QTCM model. Remove
# underscores and extra whitespace in data_name and data_units,
# replacing with a single whitespace character between words:
idx1 = data_name.find('[')
idx2 = data_name.find(']')
if idx1 != -1 and idx2 != -1:
data_name = data_name[:idx1] + data_name[idx2 + 1:]
data_name = data_name.strip()
data_name = ' '.join(data_name.replace('_', ' ').split())
data_units = ' '.join(data_units.replace('_', ' ').split())
#- Alter dimension long name to remove any units. The definition
# of units as the substring within the [] is the same as used in
# defVar in output.F90 of the compiled QTCM model. Remove
# underscores and extra whitespace in name and units, replacing
# with a single whitespace character between words, and
# capitalizing like a title:
for idimkey in dim.keys():
idimname = dimname[idimkey]
idx1 = idimname.find('[')
idx2 = idimname.find(']')
if idx1 != -1 and idx2 != -1:
idimname = idimname[:idx1] + idimname[idx2 + 1:]
dimname[idimkey] = idimname.strip()
dimname[idimkey] = \
' '.join(dimname[idimkey].replace('_',' ').split()).title()
dimunits[idimkey] = \
' '.join(dimunits[idimkey].replace('_',' ').split()).title()
#- Some data checks:
if N.rank(data) != 3:
raise ValueError, '_plot: can only plot lat, lon, time fields'
if not N.allclose(dim['time'], N.sort(dim['time'])):
raise ValueError, '_plot: time not monotonically ascending'
if not N.allclose(dim['lat'], N.sort(dim['lat'])):
raise ValueError, '_plot: lat not monotonically ascending'
if not N.allclose(dim['lon'], N.sort(dim['lon'])):
raise ValueError, '_plot: lon not monotonically ascending'
if N.shape(data)[0] != N.size(dim['time']):
raise ValueError, '_plot: data time dim mismatch'
if N.shape(data)[1] != N.size(dim['lat']):
raise ValueError, '_plot: data lat dim mismatch'
if N.shape(data)[2] != N.size(dim['lon']):
raise ValueError, '_plot: data lon dim mismatch'
#- Choose and describe ranges for lat, lon, and time. The
# section cycles through the dictionary of dimensions. idim is
# the 1-D array of the values of that dimension. rngs is a
# dictionary where each entry corresponds to a dimension, and the
# value of the entry is the values of that dimension that are to
# be plotted. rngs_idxs are the indices in the original
# dimensions array corresponding to the values in rngs.
# keys_rngs_sizes_gt_1 is a list of the keys of ranges that have
# sizes greater than 1:
rngs = {}
rngs_idxs = {}
keys_rngs_sizes_gt_1 = []
for idimkey in dim.keys():
idim = dim[idimkey]
if plotkwds[idimkey] == None:
dim_mask = N.ones(N.size(idim), dtype=int)
elif N.isscalar(plotkwds[idimkey]):
dim_mask = where_close(idim, plotkwds[idimkey])
if N.sum(dim_mask) != 1:
raise ValueError, 'no point chosen'
elif (not N.isscalar(plotkwds[idimkey])) and \
N.size(plotkwds[idimkey]) == 1:
dim_mask = where_close(idim, plotkwds[idimkey][0])
if N.sum(dim_mask) != 1:
raise ValueError, 'no point chosen'
elif N.size(plotkwds[idimkey]) == 2:
dim_mask = N.logical_and(idim >= plotkwds[idimkey][0],
idim <= plotkwds[idimkey][-1])
else:
raise ValueError, 'bad dimension range keyword entry'
rngs[idimkey] = N.compress(dim_mask, idim)
rngs_idxs[idimkey] = N.compress(dim_mask, N.arange(N.size(idim)))
if N.size(rngs[idimkey]) > 1:
keys_rngs_sizes_gt_1.append(idimkey)
#- Set plot types (line or contour):
if len(keys_rngs_sizes_gt_1) == 0:
raise ValueError, 'cannot plot without any fixed dimension'
elif len(keys_rngs_sizes_gt_1) == 1:
plottype = 'line'
elif len(keys_rngs_sizes_gt_1) == 2:
plottype = 'contour'
else:
raise ValueError, 'cannot plot with > 2 varying dimensions'
#- Set plot axis fields and axis names, depending on what sort
# of dimensions will be plotted. If lon is to be plotted, it is
# always the x-axis. If lat is to be plotted, it is always the
# y-axis. In this section and later on in a few places, I
# rely on the count method for a list as a Boolean test: If it
# returns 0, consider that False; > 0 is True. The text for the
# title and axis labels to be passed to the xlabel, etc. methods,
# are called titlename, xname, and yname:
if plottype == 'line': #+ Choose x-axis vector and
x = rngs[keys_rngs_sizes_gt_1[0]] # x/y names for line plot
xname = dimname[keys_rngs_sizes_gt_1[0]] + ' [' \
+ dimunits[keys_rngs_sizes_gt_1[0]] + ']'
yname = data_name + ' [' + data_units + ']'
elif plottype == 'contour': #+ Choose axis vectors and
if keys_rngs_sizes_gt_1.count('lon'): # names for contour plot
x = rngs['lon']
xname = dimname['lon'] + ' [' + dimunits['lon'] + ']'
if keys_rngs_sizes_gt_1.count('lat'):
y = rngs['lat']
yname = dimname['lat'] + ' [' + dimunits['lat'] + ']'
if keys_rngs_sizes_gt_1.count('time'):
if keys_rngs_sizes_gt_1.count('lon'):
y = rngs['time']
yname = dimname['time'] + ' [' + dimunits['time'] + ']'
elif keys_rngs_sizes_gt_1.count('lat'):
x = rngs['time']
xname = dimname['time'] + ' [' + dimunits['time'] + ']'
else:
raise ValueError, 'bad treatment of time'
else:
raise ValueError, 'unrecognized plottype'
#- Override xname, yname, and titlename with keywords, if they
# are not None. titlename receives data_name and data_units
# by default:
if plotkwds['xlabel'] != None:
xname = plotkwds['xlabel']
if plotkwds['ylabel'] != None:
yname = plotkwds['ylabel']
if plotkwds['title'] != None:
titlename = plotkwds['title']
else:
titlename = data_name + ' [' + data_units + ']'
#- Pick data to be plotted and plot:
pylab.clf() #+ Clear any previous figures
pylab.figure(1) #+ Open a pylab figure
if plottype == 'line': #+ Select data for a line plot
y = data[rngs_idxs['time'], # and plot
rngs_idxs['lat'], rngs_idxs['lon']]
pylab.plot(x, y)
elif plottype == 'contour': #+ Select data for a contour
ritim = rngs_idxs['time'] # plot and plot
rilat = rngs_idxs['lat']
rilon = rngs_idxs['lon']
#* Extract subarrays depending on which two dimensions are
# chosen:
if N.size(rngs_idxs['time']) == 1:
zgrid = num.MLab.squeeze(data[ritim[0], rilat[0]:rilat[-1] + 1,
rilon[0]:rilon[-1] + 1])
elif N.size(rngs_idxs['lat']) == 1:
zgrid = num.MLab.squeeze(data[ritim[0]:ritim[-1] + 1, rilat[0],
rilon[0]:rilon[-1] + 1])
elif N.size(rngs_idxs['lon']) == 1:
zgrid = num.MLab.squeeze(data[ritim[0]:ritim[-1] + 1,
rilat[0]:rilat[-1] + 1, rilon[0]])
else:
raise ValueError, 'unrecognized configuration'
#* Change zgrid for special case of a lat. vs. time contour
# plot. Calculate xgrid and ygrid:
if keys_rngs_sizes_gt_1.count('time') and \
keys_rngs_sizes_gt_1.count('lat'):
zgrid = N.transpose(zgrid)
xgrid, ygrid = pylab.meshgrid(x, y)
#* Set contour levels:
if plotkwds['levels'] == None:
levels = nice_levels(zgrid)
else:
levels = plotkwds['levels']
#- Plot (creating continents first if is a lat vs. lon plot)
# and write contour levels/color bar as appropriate:
if keys_rngs_sizes_gt_1.count('lon') and \
keys_rngs_sizes_gt_1.count('lat'):
mapplot = Basemap(projection='cyl',
resolution='l',
llcrnrlon=N.min(xgrid),
llcrnrlat=N.min(ygrid),
urcrnrlon=N.max(xgrid),
urcrnrlat=N.max(ygrid))
mapplot.drawcoastlines()
mapplot.drawmeridians(nice_levels(rngs['lon'],
approx_nlev=plotkwds['nlatlon']),
labels=[1, 0, 0, 1])
mapplot.drawparallels(nice_levels(rngs['lat'],
approx_nlev=plotkwds['nlatlon']),
labels=[1, 0, 0, 1])
if plotkwds['filled']:
plot = mapplot.contourf(xgrid, ygrid, zgrid, levels)
pylab.colorbar(plot, orientation='horizontal', format='%g')
else:
plot = mapplot.contour(xgrid, ygrid, zgrid, levels)
pylab.clabel(plot, inline=1, fontsize=10, fmt='%g')
else:
if plotkwds['filled']:
plot = pylab.contourf(xgrid, ygrid, zgrid, levels)
pylab.colorbar(plot, orientation='horizontal', format='%g')
else:
plot = pylab.contour(xgrid, ygrid, zgrid, levels)
pylab.clabel(plot, inline=1, fontsize=10, fmt='%g')
else:
raise ValueError, 'unrecognized plottype'
#- Add titling. Lat vs. lon plots do not have axis labels because
# the map labels already make it clear, and for those plots the
# title also includes the time value:
if keys_rngs_sizes_gt_1.count('lon') and \
keys_rngs_sizes_gt_1.count('lat'):
titlename = titlename + ' at ' \
+ dimname['time'] + ' ' \
+ str(rngs['time'][0]) + ' ' \
+ dimunits['time']
titlename = mpl_latex_script1(titlename)
pylab.title(titlename)
else:
titlename = mpl_latex_script1(titlename)
xname = mpl_latex_script1(xname)
yname = mpl_latex_script1(yname)
pylab.xlabel(xname)
pylab.ylabel(yname)
pylab.title(titlename)
#- Output plot to PNG file or screen. The show command seems to
# have a problem on my Mac OS X, so save to a temporary file
# and use preview to view for fn == None and tmppreview set to
# True. Note that the temporary file is not deleted by this
# method:
if plotkwds['fn'] == None: #+ Screen display
if plotkwds['tmppreview'] and sys.platform == 'darwin':
outputfn = tempfile.mkstemp('.png', 'qtcm_')
pylab.savefig(outputfn[-1])
os.system('open -a /Applications/Preview.app ' + outputfn[-1])
else:
pylab.show()
elif type(plotkwds['fn']) == type('a'): #+ Write to file
pylab.savefig(plotkwds['fn'])
pylab.close(1)
else:
raise ValueError, 'cannot write to this type of file'
def plot_ncdf_output(id, datafn, **kwds):
"""Plot model field id from the data in netCDF file datafn.
Positional Input Parameter:
* id: Name of the id of the field to plot. String.
* datafn: Filename containing the output data to plot. String.
Input keyword parameter descriptions are found in the docstring
for Qtcm methods ploti, plotm, and other methods that call this
private method. In general, those methods take the keyword
parameters they receive and pass it along unchanged as keyword
parameters to this function. In that sense, this function is
seldom used as a stand-alone function, but rather is usually
used coupled with a Qtcm instance.
The data fields read in from the netCDF output file are dimensioned
(time, lat, lon). This is different than how the data is stored
in the compiled QTCM model fields (lon, lat, time), and at the
Python level (lon, lat). The reason this is the case is that
f2py automatically makes the arrays passed between the Python
and Fortran levels match.
For a lat vs. lon plot, the contour plot is superimposed onto
a cylindrical projection map of the Earth with continents drawn
and labeled meridians and parallels. The title also includes
the model time, and x- and y-axis labels are not drawn.
All numerical data used for plotting come from the netCDF output
file for consistency (e.g., the dimensions of u1). Currently
this method only works for 3-D data arrays (two in space, one
in time).
"""
#- Accomodate other ids. The id that this routine will use
# (i.e., iduse corresponds to the name in the netCDF output file)
# is called iduse. Set this to id, except for the case where
# some aliases of ids are entered in which iduse is the alias:
if id == 'Qc': iduse = 'Prec'
elif id == 'FLWut': iduse = 'OLR'
elif id == 'STYPE': iduse = 'stype'
else: iduse = id
#- Set defined keyword defaults. All are set to None except for
# nlatlon which gets an integer:
plotkwds_ids = ['lat', 'lon', 'time', 'fn', 'levels', 'title',
'xlabel', 'ylabel',
'filled', 'nlatlon', 'tmppreview']
plotkwds = {}
for ikey in plotkwds_ids:
if kwds.has_key(ikey):
plotkwds[ikey] = copy.copy(kwds[ikey])
else:
plotkwds[ikey] = None
if not kwds.has_key('nlatlon'):
plotkwds['nlatlon'] = 8
#- Get data and dimensions of iduse to plot:
fileobj = S.NetCDFFile(datafn, mode='r')
data = N.array(fileobj.variables[iduse].getValue())
data_name = fileobj.variables[iduse].long_name
data_units = fileobj.variables[iduse].units
dim = {}
dimname = {}
dimunits = {}
dim['lat'] = N.array(fileobj.variables['lat'].getValue())
dimname['lat'] = fileobj.variables['lat'].long_name
dimunits['lat'] = fileobj.variables['lat'].units
dim['lon'] = N.array(fileobj.variables['lon'].getValue())
dimname['lon'] = fileobj.variables['lon'].long_name
dimunits['lon'] = fileobj.variables['lon'].units
dim['time'] = N.array(fileobj.variables['time'].getValue())
dimname['time'] = fileobj.variables['time'].long_name
dimunits['time'] = fileobj.variables['time'].units
fileobj.close()
#- Alter data long name to remove any units. The definition
# of units as the substring within the [] is the same as used in
# defVar in output.F90 of the compiled QTCM model. Remove
# underscores and extra whitespace in data_name and data_units,
# replacing with a single whitespace character between words:
idx1 = data_name.find('[')
idx2 = data_name.find(']')
if idx1 != -1 and idx2 != -1:
data_name = data_name[:idx1] + data_name[idx2+1:]
data_name = data_name.strip()
data_name = ' '.join(data_name.replace('_',' ').split())
data_units = ' '.join(data_units.replace('_',' ').split())
#- Alter dimension long name to remove any units. The definition
# of units as the substring within the [] is the same as used in
# defVar in output.F90 of the compiled QTCM model. Remove
# underscores and extra whitespace in name and units, replacing
# with a single whitespace character between words, and
# capitalizing like a title:
for idimkey in dim.keys():
idimname = dimname[idimkey]
idx1 = idimname.find('[')
idx2 = idimname.find(']')
if idx1 != -1 and idx2 != -1:
idimname = idimname[:idx1] + idimname[idx2+1:]
dimname[idimkey] = idimname.strip()
dimname[idimkey] = \
' '.join(dimname[idimkey].replace('_',' ').split()).title()
dimunits[idimkey] = \
' '.join(dimunits[idimkey].replace('_',' ').split()).title()
#- Some data checks:
if N.rank(data) != 3:
raise ValueError, '_plot: can only plot lat, lon, time fields'
if not N.allclose(dim['time'], N.sort(dim['time'])):
raise ValueError, '_plot: time not monotonically ascending'
if not N.allclose(dim['lat'], N.sort(dim['lat'])):
raise ValueError, '_plot: lat not monotonically ascending'
if not N.allclose(dim['lon'], N.sort(dim['lon'])):
raise ValueError, '_plot: lon not monotonically ascending'
if N.shape(data)[0] != N.size(dim['time']):
raise ValueError, '_plot: data time dim mismatch'
if N.shape(data)[1] != N.size(dim['lat']):
raise ValueError, '_plot: data lat dim mismatch'
if N.shape(data)[2] != N.size(dim['lon']):
raise ValueError, '_plot: data lon dim mismatch'
#- Choose and describe ranges for lat, lon, and time. The
# section cycles through the dictionary of dimensions. idim is
# the 1-D array of the values of that dimension. rngs is a
# dictionary where each entry corresponds to a dimension, and the
# value of the entry is the values of that dimension that are to
# be plotted. rngs_idxs are the indices in the original
# dimensions array corresponding to the values in rngs.
# keys_rngs_sizes_gt_1 is a list of the keys of ranges that have
# sizes greater than 1:
rngs = {}
rngs_idxs = {}
keys_rngs_sizes_gt_1 = []
for idimkey in dim.keys():
idim = dim[idimkey]
if plotkwds[idimkey] == None:
dim_mask = N.ones( N.size(idim), dtype=int )
elif N.isscalar(plotkwds[idimkey]):
dim_mask = where_close( idim, plotkwds[idimkey] )
if N.sum(dim_mask) != 1:
raise ValueError, 'no point chosen'
elif (not N.isscalar(plotkwds[idimkey])) and \
N.size(plotkwds[idimkey]) == 1:
dim_mask = where_close( idim, plotkwds[idimkey][0] )
if N.sum(dim_mask) != 1:
raise ValueError, 'no point chosen'
elif N.size(plotkwds[idimkey]) == 2:
dim_mask = N.logical_and( idim >= plotkwds[idimkey][0],
idim <= plotkwds[idimkey][-1] )
else:
raise ValueError, 'bad dimension range keyword entry'
rngs[idimkey] = N.compress( dim_mask, idim )
rngs_idxs[idimkey] = N.compress( dim_mask, N.arange(N.size(idim)) )
if N.size(rngs[idimkey]) > 1:
keys_rngs_sizes_gt_1.append(idimkey)
#- Set plot types (line or contour):
if len(keys_rngs_sizes_gt_1) == 0:
raise ValueError, 'cannot plot without any fixed dimension'
elif len(keys_rngs_sizes_gt_1) == 1:
plottype = 'line'
elif len(keys_rngs_sizes_gt_1) == 2:
plottype = 'contour'
else:
raise ValueError, 'cannot plot with > 2 varying dimensions'
#- Set plot axis fields and axis names, depending on what sort
# of dimensions will be plotted. If lon is to be plotted, it is
# always the x-axis. If lat is to be plotted, it is always the
# y-axis. In this section and later on in a few places, I
# rely on the count method for a list as a Boolean test: If it
# returns 0, consider that False; > 0 is True. The text for the
# title and axis labels to be passed to the xlabel, etc. methods,
# are called titlename, xname, and yname:
if plottype == 'line': #+ Choose x-axis vector and
x = rngs[keys_rngs_sizes_gt_1[0]] # x/y names for line plot
xname = dimname[keys_rngs_sizes_gt_1[0]] + ' [' \
+ dimunits[keys_rngs_sizes_gt_1[0]] + ']'
yname = data_name + ' [' + data_units + ']'
elif plottype == 'contour': #+ Choose axis vectors and
if keys_rngs_sizes_gt_1.count('lon'): # names for contour plot
x = rngs['lon']
xname = dimname['lon'] + ' [' + dimunits['lon'] + ']'
if keys_rngs_sizes_gt_1.count('lat'):
y = rngs['lat']
yname = dimname['lat'] + ' [' + dimunits['lat'] + ']'
if keys_rngs_sizes_gt_1.count('time'):
if keys_rngs_sizes_gt_1.count('lon'):
y = rngs['time']
yname = dimname['time'] + ' [' + dimunits['time'] + ']'
elif keys_rngs_sizes_gt_1.count('lat'):
x = rngs['time']
xname = dimname['time'] + ' [' + dimunits['time'] + ']'
else:
raise ValueError, 'bad treatment of time'
else:
raise ValueError, 'unrecognized plottype'
#- Override xname, yname, and titlename with keywords, if they
# are not None. titlename receives data_name and data_units
# by default:
if plotkwds['xlabel'] != None:
xname = plotkwds['xlabel']
if plotkwds['ylabel'] != None:
yname = plotkwds['ylabel']
if plotkwds['title'] != None:
titlename = plotkwds['title']
else:
titlename = data_name + ' [' + data_units + ']'
#- Pick data to be plotted and plot:
pylab.clf() #+ Clear any previous figures
pylab.figure(1) #+ Open a pylab figure
if plottype == 'line': #+ Select data for a line plot
y = data[rngs_idxs['time'], # and plot
rngs_idxs['lat'],
rngs_idxs['lon']]
pylab.plot(x, y)
elif plottype == 'contour': #+ Select data for a contour
ritim = rngs_idxs['time'] # plot and plot
rilat = rngs_idxs['lat']
rilon = rngs_idxs['lon']
#* Extract subarrays depending on which two dimensions are
# chosen:
if N.size(rngs_idxs['time']) == 1:
zgrid = num.MLab.squeeze(data[ ritim[0],
rilat[0]:rilat[-1]+1,
rilon[0]:rilon[-1]+1 ])
elif N.size(rngs_idxs['lat']) == 1:
zgrid = num.MLab.squeeze(data[ ritim[0]:ritim[-1]+1,
rilat[0],
rilon[0]:rilon[-1]+1 ])
elif N.size(rngs_idxs['lon']) == 1:
zgrid = num.MLab.squeeze(data[ ritim[0]:ritim[-1]+1,
rilat[0]:rilat[-1]+1,
rilon[0] ])
else:
raise ValueError, 'unrecognized configuration'
#* Change zgrid for special case of a lat. vs. time contour
# plot. Calculate xgrid and ygrid:
if keys_rngs_sizes_gt_1.count('time') and \
keys_rngs_sizes_gt_1.count('lat'):
zgrid = N.transpose(zgrid)
xgrid, ygrid = pylab.meshgrid(x, y)
#* Set contour levels:
if plotkwds['levels'] == None:
levels = nice_levels(zgrid)
else:
levels = plotkwds['levels']
#- Plot (creating continents first if is a lat vs. lon plot)
# and write contour levels/color bar as appropriate:
if keys_rngs_sizes_gt_1.count('lon') and \
keys_rngs_sizes_gt_1.count('lat'):
mapplot = Basemap(projection='cyl', resolution='l',
llcrnrlon=N.min(xgrid), llcrnrlat=N.min(ygrid),
urcrnrlon=N.max(xgrid), urcrnrlat=N.max(ygrid))
mapplot.drawcoastlines()
mapplot.drawmeridians(nice_levels(rngs['lon'],
approx_nlev=plotkwds['nlatlon']),
labels=[1,0,0,1])
mapplot.drawparallels(nice_levels(rngs['lat'],
approx_nlev=plotkwds['nlatlon']),
labels=[1,0,0,1])
if plotkwds['filled']:
plot = mapplot.contourf(xgrid, ygrid, zgrid, levels)
pylab.colorbar(plot, orientation='horizontal', format='%g')
else:
plot = mapplot.contour(xgrid, ygrid, zgrid, levels)
pylab.clabel(plot, inline=1, fontsize=10, fmt='%g')
else:
if plotkwds['filled']:
plot = pylab.contourf(xgrid, ygrid, zgrid, levels)
pylab.colorbar(plot, orientation='horizontal', format='%g')
else:
plot = pylab.contour(xgrid, ygrid, zgrid, levels)
pylab.clabel(plot, inline=1, fontsize=10, fmt='%g')
else:
raise ValueError, 'unrecognized plottype'
#- Add titling. Lat vs. lon plots do not have axis labels because
# the map labels already make it clear, and for those plots the
# title also includes the time value:
if keys_rngs_sizes_gt_1.count('lon') and \
keys_rngs_sizes_gt_1.count('lat'):
titlename = titlename + ' at ' \
+ dimname['time'] + ' ' \
+ str(rngs['time'][0]) + ' ' \
+ dimunits['time']
titlename = mpl_latex_script1(titlename)
pylab.title(titlename)
else:
titlename = mpl_latex_script1(titlename)
xname = mpl_latex_script1(xname)
yname = mpl_latex_script1(yname)
pylab.xlabel(xname)
pylab.ylabel(yname)
pylab.title(titlename)
#- Output plot to PNG file or screen. The show command seems to
# have a problem on my Mac OS X, so save to a temporary file
# and use preview to view for fn == None and tmppreview set to
# True. Note that the temporary file is not deleted by this
# method:
if plotkwds['fn'] == None: #+ Screen display
if plotkwds['tmppreview'] and sys.platform == 'darwin':
outputfn = tempfile.mkstemp('.png','qtcm_')
pylab.savefig(outputfn[-1])
os.system('open -a /Applications/Preview.app '+outputfn[-1])
else:
pylab.show()
elif type(plotkwds['fn']) == type('a'): #+ Write to file
pylab.savefig(plotkwds['fn'])
pylab.close(1)
else:
raise ValueError, 'cannot write to this type of file'
