It's Progress
Looks like it has been almost a year since the last point release, since I want to feel good about this, it is because the code base is stable and robust and definitely not for any other reason like the lead developer spending 6 months at sea collecting reference quality hydrographic data. The changes being worked on here related to automation efforts at CCHDO, a highlight being the porting of the coards netcdf and woce file generators. That's right, we are committed to providing hydrographic data in your favorite formats and are working on automating the process of making these data available for all our cruises.
-
Add
read_csv
method -
(bug) Remove the
C_format
andC_format_source
attributes for non floating point variables. Integer and string values are exact so do not need any sort of format hint. Including a format string for non floating point values is undefined behavior in the netCDF-C Library and can result in crashing. -
(new) Add
to_coards()
andto_woce()
accessors to maintain legacy formats at CCHDO. -
(new) All the
to_*
accessors now support a path argument that will accept a writeable binary mode file like object or a filesystem path to write to. -
(new) Add a
compact_profile()
accessor that drops the trailing fill values from a profile -
(new) Add the a
file_seperator
andkeep_seperator
tocchdo.hydro.exchange.read_exchange()
.
Thekeep_seperator
argument defaults to True.
This is specifically to allow the reading of CTD exchange files that have been concatenated together (rather than zipped).
Assuming there is nothing after "END_DATA" and you cat a bunch of _ct1.csv files together, they should be readable if "END_DATA" is passed into thefile_seperator
argument. -
(new) Add
--dump-data-counts
option to the exchange status generator which will dump a json document containing a object with nc_var name strings to count integers of how many
variables with this name actually contain any data (i.e. are not just entirely fill value). -
Add a
--version
option to the cli interface -
(changed) Export
read_exchange
from the top levelcchdo.hydro
namespace. -
(changed) Bump min
cchdo.params
version to 0.1.21 -
(changed) Dropped netCDF4 as required for installation, if netCDF4 isn't installed already you can install with the
cchdo.hydro[netcdf4]
optional.- While this might seem like an odd choice for a library that started as one to convert WHP Exchange files to netCDf, netCDF
itself is not called until the very end of the conversion process. Internally, everything is anxarray.Dataset
. This means you can
install this library to read exchange files in tricky environments like pyodide or jupyterlite which already tend to have pandas and numpy in them.
- While this might seem like an odd choice for a library that started as one to convert WHP Exchange files to netCDf, netCDF
-
(bug) fix
pressure
variable not having a_FillValue
attribute