netcdf-c/ncgen
Dennis Heimbigner 231ae96c4b Add support for Zarr string type to NCZarr
* re: https://github.com/Unidata/netcdf-c/pull/2278
* re: https://github.com/Unidata/netcdf-c/issues/2485
* re: https://github.com/Unidata/netcdf-c/issues/2474

This PR subsumes PR https://github.com/Unidata/netcdf-c/pull/2278.
Actually is a bit an omnibus covering several issues.

## PR https://github.com/Unidata/netcdf-c/pull/2278
Add support for the Zarr string type.
Zarr strings are restricted currently to be of fixed size.
The primary issue to be addressed is to provide a way for user to
specify the size of the fixed length strings. This is handled by providing
the following new attributes special:
1. **_nczarr_default_maxstrlen** —
This is an attribute of the root group. It specifies the default
maximum string length for string types. If not specified, then
it has the value of 64 characters.
2. **_nczarr_maxstrlen** —
This is a per-variable attribute. It specifies the maximum
string length for the string type associated with the variable.
If not specified, then it is assigned the value of
**_nczarr_default_maxstrlen**.

This PR also requires some hacking to handle the existing netcdf-c NC_CHAR
type, which does not exist in zarr. The goal was to choose numpy types for
both the netcdf-c NC_STRING type and the netcdf-c NC_CHAR type such that
if a pure zarr implementation read them, it would still work and an
NC_CHAR type would be handled by zarr as a string of length 1.

For writing variables and NCZarr attributes, the type mapping is as follows:
* "|S1" for NC_CHAR.
* ">S1" for NC_STRING && MAXSTRLEN==1
* ">Sn" for NC_STRING && MAXSTRLEN==n

Note that it is a bit of a hack to use endianness, but it should be ok since for
string/char, the endianness has no meaning.

For reading attributes with pure zarr (i.e. with no nczarr
atribute types defined), they will always be interpreted as of
type NC_CHAR.

## Issue: https://github.com/Unidata/netcdf-c/issues/2474
This PR partly fixes this issue because it provided more
comprehensive support for Zarr attributes that are JSON valued expressions.
This PR still does not address the problem in that issue where the
_ARRAY_DIMENSION attribute is incorrectly set. Than can only be
fixed by the creator of the datasets.

## Issue: https://github.com/Unidata/netcdf-c/issues/2485
This PR also fixes the scalar failure shown in this issue.
It generally cleans up scalar handling.
It also adds a note to the documentation describing that
NCZarr supports scalars while Zarr does not and also how
scalar interoperability is achieved.

## Misc. Other Changes
1. Convert the nczarr special attributes and keys to be all lower case. So "_NCZARR_ATTR" now used "_nczarr_attr. Support back compatibility for the upper case names.
2. Cleanup my too-clever-by-half handling of scalars in libnczarr.
2022-08-27 20:21:13 -06:00
..
bindata.c Add support for Zarr string type to NCZarr 2022-08-27 20:21:13 -06:00
bytebuffer.c Support MSYS2/Mingw platform 2021-12-23 22:18:56 -07:00
bytebuffer.h ncgen directory updated 2018-12-06 15:40:43 -07:00
c0_4.cdl Tweaking cdl files so that we can compare against them. 2016-11-18 11:07:20 -07:00
c0.cdl Tweaking cdl files so that we can compare against them. 2016-11-18 11:07:20 -07:00
c5.cdl merge-squash 2015-10-09 10:12:11 -06:00
cdata.c Regularize the semantics of mkstemp. 2021-05-14 11:33:03 -06:00
cdfdata.c ncgen directory updated 2018-12-06 15:40:43 -07:00
CMakeLists.txt Provide a Number of fixes/improvements to NCZarr 2020-11-19 17:01:04 -07:00
cmldata.c Regularize the semantics of mkstemp. 2021-05-14 11:33:03 -06:00
compound_datasize_test2.cdl support fixes for Github issue 323 2016-11-17 15:29:32 -07:00
compound_datasize_test.cdl Reformated source cdl to allow for a diff test. 2016-11-16 10:57:36 -07:00
ctests.sh Primary change: add dap4 support 2017-03-08 17:01:10 -07:00
cvt.c Cleaned up another undefined reference. 2022-01-24 14:44:28 -07:00
data.c Fix various problem around VLEN's 2022-01-08 18:30:00 -07:00
data.h This PR adds EXPERIMENTAL support for accessing data in the 2020-06-28 18:02:47 -06:00
debug.c ncgen directory updated 2018-12-06 15:40:43 -07:00
debug.h Fix ncgen handling of big data sections 2020-05-14 11:20:46 -06:00
depend
dump.c Explicitly disallow variable length type compression 2022-02-19 16:47:31 -07:00
dump.h ncgen directory updated 2018-12-06 15:40:43 -07:00
env Use short "-k" codes instead of deprecated version numbers for ncgen and nccopy tests 2014-12-28 22:42:05 -07:00
escapes.c ncgen directory updated 2018-12-06 15:40:43 -07:00
f77data.c This PR adds EXPERIMENTAL support for accessing data in the 2020-06-28 18:02:47 -06:00
foo.cdl
ftests.sh Primary change: add dap4 support 2017-03-08 17:01:10 -07:00
genbin.c Merge branch 'csz_bitround' of https://github.com/nco/netcdf-c into gh2232.wif 2022-04-01 10:43:34 -06:00
genc.c Merge pull request #2339 from catenacyber/leak 2022-05-17 16:46:03 -06:00
genchar.c Merge branch 'ncgenchunks.dmh' of https://github.com/DennisHeimbigner/netcdf-c into master 2020-09-09 10:24:33 -06:00
gencml.c Docs migration 2021-11-11 10:47:49 -07:00
generate.c Fix the handling of certain alias types on CDL files. 2021-04-13 16:56:43 -06:00
generate.h This PR adds EXPERIMENTAL support for accessing data in the 2020-06-28 18:02:47 -06:00
generr.c Regularize the semantics of mkstemp. 2021-05-14 11:33:03 -06:00
generr.h This PR adds EXPERIMENTAL support for accessing data in the 2020-06-28 18:02:47 -06:00
genf77.c This PR adds EXPERIMENTAL support for accessing data in the 2020-06-28 18:02:47 -06:00
genj.c This PR adds EXPERIMENTAL support for accessing data in the 2020-06-28 18:02:47 -06:00
genjjni.c Regularize the semantics of mkstemp. 2021-05-14 11:33:03 -06:00
genjstd.c ncgen directory updated 2018-12-06 15:40:43 -07:00
genlib.c This PR adds EXPERIMENTAL support for accessing data in the 2020-06-28 18:02:47 -06:00
genlib.h Fix the handling of certain alias types on CDL files. 2021-04-13 16:56:43 -06:00
getfill.c This PR adds EXPERIMENTAL support for accessing data in the 2020-06-28 18:02:47 -06:00
includes.h This PR adds EXPERIMENTAL support for accessing data in the 2020-06-28 18:02:47 -06:00
internals.html Spelling fixes 2019-09-18 08:03:01 -06:00
jdata.c This PR adds EXPERIMENTAL support for accessing data in the 2020-06-28 18:02:47 -06:00
jdatajni.c ncgen directory updated 2018-12-06 15:40:43 -07:00
jdatastd.c ncgen directory updated 2018-12-06 15:40:43 -07:00
jtests.sh Use short "-k" codes instead of deprecated version numbers for ncgen and nccopy tests 2014-12-28 22:42:05 -07:00
lfs-tests Fix pull request https://github.com/Unidata/netcdf-c/pull/374 (dap4.dmh) 2017-04-03 21:39:44 -06:00
list.c ncgen directory updated 2018-12-06 15:40:43 -07:00
list.h ncgen directory updated 2018-12-06 15:40:43 -07:00
main_cpp.cpp This PR adds EXPERIMENTAL support for accessing data in the 2020-06-28 18:02:47 -06:00
main.c Fix Mingw versus XGetopt (again) 2021-05-26 14:27:27 -06:00
Makefile.am Add support for Zarr string type to NCZarr 2022-08-27 20:21:13 -06:00
makeparser.sh Swapped /bin/bash for /bin/sh to test on osx. 2018-08-12 23:01:08 -06:00
ncf199.cdl Updating ncgen run_nc4_tests.sh script to ensure that results are tested in addition to whether or not ncgen exited successfully. 2016-11-16 11:09:14 -07:00
ncf345.cdl Docs migration 2021-11-11 10:47:49 -07:00
ncgen.1 Support MSYS2/Mingw platform 2021-12-23 22:18:56 -07:00
ncgen.h Add BitRound to ncgen 2022-02-19 16:08:36 -08:00
ncgen.l Add support for Zarr string type to NCZarr 2022-08-27 20:21:13 -06:00
ncgen.y Add BitRound to ncgen 2022-02-19 16:08:36 -08:00
ncgenl.c Add support for Zarr string type to NCZarr 2022-08-27 20:21:13 -06:00
ncgeny.c Add support for Zarr string type to NCZarr 2022-08-27 20:21:13 -06:00
ncgeny.h Add support for Zarr string type to NCZarr 2022-08-27 20:21:13 -06:00
odom.c ncgen directory updated 2018-12-06 15:40:43 -07:00
odom.h ncgen directory updated 2018-12-06 15:40:43 -07:00
ref_camrun.cdl Spelling fixes 2019-09-18 08:03:01 -06:00
run_tests2.sh Primary change: add dap4 support 2017-03-08 17:01:10 -07:00
semantics.c Fix various problem around VLEN's 2022-01-08 18:30:00 -07:00
tst_gattenum.cdl Apparently we have no .cdl test cases that have 2017-03-18 17:57:48 -06:00
tst_usuffix.cdl re: gihub issue https://github.com/Unidata/netcdf-c/issues/380 2017-03-24 18:56:14 -06:00
util.c Add filter support to NCZarr 2021-09-02 17:04:26 -06:00
util.h This PR adds EXPERIMENTAL support for accessing data in the 2020-06-28 18:02:47 -06:00