What's coming in the next release of PyNGL and PyNIO
Version 1.3.0 - no scheduled release date
We hope to release this version as open source under a license similar to the The University of Illinois/NCSA Open Source license.
- New analysis functions:
- Ngl.betainc - Evaluates the incomplete beta function.
- Ngl.chiinv - Evaluates the inverse chi-squared distribution function.
- Ngl.linmsg - Linearly interpolates to fill in missing values.
- Ngl.regline - Calculates the linear regression coefficient between two series.
- New visualization and related functions:
- Ngl.datatondc - routine for converting between data space and NDC space.
- Ngl.ndctodata - routine for converting between NDC space and data space.
- Ngl.streamline_scalar - routine for generating streamlines colored by scalar fields.
- Ngl.streamline_scalar_map - routine for generating streamlines colored by scalar fields over a map.
- Ngl.wmstnm - draws station model data.
- New examples:
- New bar1/bar2 examples showing how to create bar charts.
- New clmdiv2 example showing how to color climate divisions by a third field.
- New datatondc example showing how to use Ngl.datatondc.
- New ndc_grid example showing how to use Ngl.draw_ndc_grid to help place primitives using NDC coordinates.
- New stream_scalar example showing how to use Ngl.streamline_scalar_map.
- New Ngl.wmstnm examples showing how to use Ngl.wmstnm.
- Augmentations
- A new optional argument has been added to Ngl.asciiread to allow for the specification of a separator character, or character sequence.
- Ngl.add_cyclic,
Ngl.add_new_coord_limits,
Ngl.add_polymarker,
Ngl.add_polygon,
Ngl.add_polyline,
Ngl.contour,
Ngl.contour_map,
Ngl.polygon,
Ngl.polyline,
Ngl.polymarker,
Ngl.streamline,
Ngl.streamline_map,
Ngl.streamline_scalar,
Ngl.streamline_scalar_map,
Ngl.vector,
Ngl.vector_map,
Ngl.vector_scalar,
Ngl.vector_scalar_map,
Ngl.xy,
Ngl.y - these plotting functions
were updated to recognize masked arrays and to not plot values
equal to the masked array's fill_value.
- Several examples in the gallery were updated to use masked arrays.
- A new optional argument has been added to Ngl.asciiread to allow for the specification of a separator character, or character sequence.
Support for maskedarray moduled added
As mentioned in the augmentations list above, support for masked arrays has been added to many of the visualization functions and is included in some of the new analysis functions. You can use either "numpy.core.ma" (from numpy 1.0.4 and earlier) or the new masked array module in numpy 1.0.5 and greater.
See the "overlay1.py" and "irregular.py" examples in the gallery for an example of using masked arrays.
- Instances of
PyErr_Printhave been removed from PyNIO. This changes the behavior of PyNIO in that scripts will exit unless the user traps the error in Python. This is an unavoidable incompatibility in order to bring PyNIO into compliance with standard Python practice. - Several instances of
PyMem_DELin the PyNIO code have been replaced withPyObject_DEL. - Fixed a problem that enables you to retrieve area group
information for climate divisions (basically, this fix will enable you
to run the new clmdiv2.py script).
- Ngl.asciiread was fixed so that
it does not exit when encountering a blank line. This was necessary
to get PyNIO to work with Python 2.5.
- The vector plotting functions: Ngl.vector, Ngl.vector_map, Ngl.vector_scalar, and Ngl.vector_scalar_map, were fixed such that
if vcMonoLineArrowColor, vcMonoFillArrowEdgeColor, vcMonoFillArrowFillColor, or vcMonoWindBarbColor are set to False, then
a labelbar is automatically drawn (unless if lbLabelBarOn is set to False and/or pmLabelBarDisplayMode is set to "Never").
In this release of PyNGL and PyNIO, we are dropping support for Numeric. An informal survey indicated that most of not all of our users have made the transition to NumPy, or are at least planning to very soon. We are adding several new data analysis functions, and trying to keep support for Numeric and NumPy was getting to be a bit tedious.