epygram.fields.V1DField
— Vertical 1-D Field¶
Contains the class that handle a Vertical 1D field.
-
class
epygram.fields.V1DField.
V1DCommonField
(*args, **kwargs)[source]¶ Bases:
epygram.fields.D3Field._D3CommonField
Vertical 1-Dimension (column) virtual or not field class. A field is defined by its identifier ‘fid’, its data, its geometry, and its validity.
Note
This class is managed by footprint.
- info: Not documented
- priority: PriorityLevel::DEFAULT (rank=1)
Automatic parameters from the footprint:
- comment (
builtins.str
) - rwd - Not documented, sorry.- Optional. Default is None.
- fid (
footprints.stdtypes.FPDict
) - rwx - Not documented, sorry. - misc_metadata (
footprints.stdtypes.FPDict
) - rwd - Not documented, sorry.- Optional. Default is FPDict::<<as_dict:: dict()>>.
- structure (
builtins.str
) - rxx - Type of Field geometry.- Values: set([‘V1D’])
- units (
builtins.str
) - rwd - Not documented, sorry.- Optional. Default is ‘’.
Constructor. See its footprint for arguments.
-
comment
¶ Undocumented footprint attribute
-
fid
¶ Undocumented footprint attribute
-
misc_metadata
¶ Undocumented footprint attribute
-
plotfield
(*args, **kwargs)[source]¶ Interface method to methods plotprofiles() and plotverticalhovmoller(), depending on time dimension (or not).
Cf. these functions for arguments.
-
structure
¶ Undocumented footprint attribute
-
units
¶ Undocumented footprint attribute
-
class
epygram.fields.V1DField.
V1DField
(*args, **kwargs)[source]¶ Bases:
epygram.fields.V1DField.V1DCommonField
,epygram.fields.D3Field.D3Field
Vertical 1-Dimension (column) real field class. A field is defined by its identifier ‘fid’, its data, its geometry, and its validity.
Note
This class is managed by footprint.
- info: Not documented
- priority: PriorityLevel::DEFAULT (rank=1)
Automatic parameters from the footprint:
- comment (
builtins.str
) - rwd - Not documented, sorry.- Optional. Default is None.
- fid (
footprints.stdtypes.FPDict
) - rwx - Not documented, sorry. - geometry (
epygram.geometries.V1DGeometry.V1DGeometry
) - rwx - Geometry defining the position of the field gridpoints. - misc_metadata (
footprints.stdtypes.FPDict
) - rwd - Not documented, sorry.- Optional. Default is FPDict::<<as_dict:: dict()>>.
- processtype (
builtins.str
) - rwx - Generating process.- Optional. Default is None.
- spectral_geometry (
epygram.geometries.SpectralGeometry.SpectralGeometry
) - rxx - For a spectral field, its spectral geometry handles spectral transforms and dimensions.- Optional. Default is None.
- structure (
builtins.str
) - rxx - Type of Field geometry.- Values: set([‘V1D’])
- units (
builtins.str
) - rwd - Not documented, sorry.- Optional. Default is ‘’.
- validity (
epygram.base.FieldValidityList
) - rwx - Validity of the field.- Optional. Default is FieldValidityList::<<as_list:: [FieldValidity::<epygram.base.FieldValidity object at 0x7f60a4f9f588>]>>.
Constructor. See its footprint for arguments.
-
comment
¶ Undocumented footprint attribute
-
fid
¶ Undocumented footprint attribute
-
geometry
¶ Undocumented footprint attribute
-
misc_metadata
¶ Undocumented footprint attribute
-
processtype
¶ Undocumented footprint attribute
-
spectral_geometry
¶ Undocumented footprint attribute
-
structure
¶ Undocumented footprint attribute
-
units
¶ Undocumented footprint attribute
-
validity
¶ Undocumented footprint attribute
-
class
epygram.fields.V1DField.
V1DVirtualField
(*args, **kwargs)[source]¶ Bases:
epygram.fields.V1DField.V1DCommonField
,epygram.fields.D3Field.D3VirtualField
Vertical 1-Dimension (column) virtual field class. A field is defined by its identifier ‘fid’, its data, its geometry, and its validity.
Note
This class is managed by footprint.
- info: Not documented
- priority: PriorityLevel::DEFAULT (rank=1)
Automatic parameters from the footprint:
- comment (
builtins.str
) - rwd - Not documented, sorry.- Optional. Default is None.
- fid (
footprints.stdtypes.FPDict
) - rwx - Not documented, sorry. - fieldset (
epygram.base.FieldSet
) - rxx - Set of real fields that can compose the Virtual Field.- Optional. Default is FieldSet::<<as_list:: []>>.
- misc_metadata (
footprints.stdtypes.FPDict
) - rwd - Not documented, sorry.- Optional. Default is FPDict::<<as_dict:: dict()>>.
- resource (
epygram.base.Resource
) - rxx - Resource in which is stored the fields defined by resource_fids.- Optional. Default is None.
- resource_fids (
footprints.stdtypes.FPList
) - rxx - Definition of the fields in resource that compose the virtual field.- Optional. Default is FPList::<<as_list:: []>>.
- structure (
builtins.str
) - rxx - Type of Field geometry.- Values: set([‘V1D’])
- units (
builtins.str
) - rwd - Not documented, sorry.- Optional. Default is ‘’.
-
comment
¶ Undocumented footprint attribute
-
fid
¶ Undocumented footprint attribute
-
fieldset
¶ Undocumented footprint attribute
-
misc_metadata
¶ Undocumented footprint attribute
-
resource
¶ Undocumented footprint attribute
-
resource_fids
¶ Undocumented footprint attribute
-
structure
¶ Undocumented footprint attribute
-
units
¶ Undocumented footprint attribute
Functions¶
-
epygram.fields.V1DField.
plotprofiles
(profiles, over=(None, None), labels=None, fidkey=None, Ycoordinate=None, unit='SI', title=None, logscale=False, ema=False, zoom=None, figsize=(6.0, 9.0), rcparams=None, colors=None, legend_kwargs=None)[source]¶ To plot a series of profiles. Returns a tuple of
matplotlib
(Figure, ax).Parameters: - profiles – a
epygram.base.FieldSet
ofepygram.fields.V1DField
, or a singleepygram.fields.V1DField
. All profiles are supposed to have the same unit, and the same vertical coordinate. - over – any existing figure and/or ax to be used for the plot, given as a tuple (fig, ax), with None for missing objects. fig is the frame of the matplotlib figure, containing eventually several subplots (axes); ax is the matplotlib axes on which the drawing is done. When given (is not None), these objects must be coherent, e.g. ax being one of the fig axes.
- labels – a list of labels for the profiles (same length and same order).
- fidkey – key of fid for labelling the curve with fid[fidkey]; if None, labels with raw fid.
- Ycoordinate – label for the Y coordinate.
- unit – label for X coordinate.
- title – title for the plot.
- logscale – to set Y logarithmic scale
- ema – to make emagram-like plots of Temperature
- zoom –
a dict containing optional limits to zoom on the plot.
Syntax: e.g. {‘ymax’:500, …}.
- figsize – figure sizes in inches, e.g. (5, 8.5). If None, get the default figsize in config.plotsizes.
- rcparams –
list of (*args, **kwargs) to be passed to pyplot.rc() defaults to [((‘font’,), dict(family=’serif’)),
((‘figure’,), dict(autolayout=True))] - colors – list of matplotlib colors on which to iterate to plot each profile. Cyclic (with varying linestyle) if shorter than the number of profiles.
- legend_kwargs – kwargs to be passed to matplotlib’s legend()
- profiles – a
-
epygram.fields.V1DField.
plotverticalhovmoller
(profile, over=(None, None), fidkey=None, Ycoordinate=None, title=None, logscale=False, zoom=None, colorbar='vertical', graphicmode='colorshades', minmax=None, levelsnumber=21, center_cmap_on_0=False, colormap='jet', minmax_in_title=True, contourcolor='k', contourwidth=1, contourlabel=True, datefmt=None, showgrid=True, figsize=(6.0, 9.0), rcparams=None)[source]¶ Makes a simple vertical Hovmöller plot of the field.
Parameters: - profile – being a
epygram.fields.V1DField
- over – any existing figure and/or ax to be used for the plot, given as a tuple (fig, ax), with None for missing objects. fig is the frame of the matplotlib figure, containing eventually several subplots (axes); ax is the matplotlib axes on which the drawing is done. When given (is not None), these objects must be coherent, i.e. ax being one of the fig axes.
- fidkey – type of fid for entitling the plot with fid[fidkey], if title is None; if None, labels with raw fid.
- Ycoordinate – label for the Y coordinate.
- title – title for the plot.
- logscale – to set Y logarithmic scale
- zoom –
a dict containing optional limits to zoom on the plot.
Syntax: e.g. {‘ymax’:500, …}.
- colorbar – if False, hide colorbar the plot; else, befines the colorbar orientation, among (‘horizontal’, ‘vertical’). Defaults to ‘vertical’.
- graphicmode – among (‘colorshades’, ‘contourlines’).
- minmax –
defines the min and max values for the plot colorbar.
Syntax: [min, max]. [0.0, max] also works. Default is min/max of the field.
- levelsnumber – number of levels for contours and colorbar.
- center_cmap_on_0 – aligns the colormap center on the value 0.
- colormap – name of the matplotlib colormap to use.
- minmax_in_title – if True and minmax is not None, adds min and max values in title
- contourcolor – color or colormap to be used for ‘contourlines’ graphicmode. It can be either a legal html color name, or a colormap name.
- contourwidth – width of contours for ‘contourlines’ graphicmode.
- contourlabel – displays labels on contours.
- datefmt – date format to use, e.g. “%Y-%m-%d %H:%M:%S %Z”
- showgrid – True/False to show grid or not
- figsize – figure sizes in inches, e.g. (5, 8.5). If None, get the default figsize in config.plotsizes.
- rcparams – list of (*args, **kwargs) to be passed to pyplot.rc() defaults to [((‘font’,), dict(family=’serif’)),]
Warning: requires matplotlib.
- profile – being a
-
epygram.fields.V1DField.
plotanimation
(profile, title='__auto__', repeat=False, interval=1000, **kwargs)[source]¶ To plot a time-dependent profile as an animation. Returns a
matplotlib.animation.FuncAnimation
.Parameters: - profile – the
epygram.fields.V1DField
to plot. - title – title for the plot. ‘__auto__’ (default) will print the current validity of the time frame.
- repeat – to repeat animation
- interval – number of milliseconds between two validities
Other kwargs passed to plotprofiles().
- profile – the