Utility for interaction with CF compliant NetCDF flag variables.
Project description
So… you want to inspect CF Compliant NetCDF flag variables?
CF Compliant NetCDF Flag variables are integer flags associated with, or having:
flag_values
flag_meanings
flag_masks (optionally)
Read the CF Conventions on flags for more information.
TL;DR
Install the utility with with pip:
pip install ncflag
On the command line, use ncflag:
Usage: ncflag [OPTIONS] NCFILE FLAG Options: -v, --version Show the version and exit. --show_flags PATH Print the flags this tool can inspect. --use_time_var TEXT -l [DEBUG|INFO|WARNING|ERROR|CRITICAL] log level --help Show this message and exit.
Notes:
Use –show_flags to discover what flags in a given file can be inspected.
Limitation: can only inspect flags of at most one dimension. See details below for dealing with multidimensional flags.
The nominal output with –use_time_var specified is shown below. Without use_time_var, the index along the dimension will be printed instead of a iso 8601 timestamp.
2017-11-27T21:07:41.543778: [u'data_quality_error']
2017-11-27T21:07:42.543812: [u'good_data']
2017-11-27T21:07:43.543807: [u'good_data']
2017-11-27T21:07:44.543802: [u'good_data']
Multidimensional Flags
Occasionally, by some poor misfortune, you may encounter multidimensional flag variables. These are currently not supported by the Command Line Interface (CLI), however, the FlagWrap class can still be used in code, or through an interactive (IPython) session. The FlagWrap.get_flags_set_at_index can be passed a tuple of indicies to get the flags set in a multidimensional flag variable. Below is an example.
from ncflag import FlagWrap
import netCDF4 as nc
with nc.Dataset("somenetcdf.nc") as nc_in:
v = nc_in.variables["mutidim_variable"]
print(v.shape) # --> (2, 10), is multidim.
w = FlagWrap(v)
print(w.get_flags_set_at_index((0, 0))) # --> ["good_quality_qf"]
API and Documentation
To use the FlagWrap in your own code, see the example above for multidimensional flags.
For documentation, please read flag_wrapper.py. It is one file and is documented with comprehensive docstrings. The functions are named descriptively. A following functions are available:
- init_zeros(cls, nc_var, shape) - get_flag(self, flag_meaning) - reduce(self, exclude_mask, axis=-1) - get_flag_at_index(self, flag_meaning, i) - get_flags_set_at_index(self, i, exit_on_good=False) - find_flag(self, options) - set_flag(self, flag_meaning, flags) - set_flag_at_index(self, flag_meaning, i) - get_value_for_meaning(self, flag_meaning) - sync(self)
Testing
TODO! (tested in production…., good enough right?)
Deploy to pip, after testing with python2 and python3:
rm -r dist/
python setup.py bdist_wheel --universal
twine upload dist/*
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distributions
Built Distribution
Hashes for ncflag-0.0.3-py2.py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | adc289fccdfa08624a3a1708de3a90fc8d17e111ca5d497f1749fed3173a2439 |
|
MD5 | 00ed2fa748dc12e294a6d973316fb157 |
|
BLAKE2b-256 | 1fb6841d0977e7691cc5ed681f6a39af4d610674e8bfbd5bf785554ae4da137c |