mirror of
https://github.com/Unidata/netcdf-c.git
synced 2025-01-12 15:45:21 +08:00
44d0dcaad2
re: https://github.com/Unidata/netcdf-c/issues/1584 Support has been added for multiple filters per variable. This affects a number of components in netcdf. The new APIs are documented in NUG/filters.md. The primary changes are: * A set of new functions are provided (see __include/netcdf_filter.h__). - Obtain a list of the filters associated with a variable - Obtain the parameters for a specific filter. * The existing __nc_inq_var_filter__ function now returns info about the first defined filter. * The utilities (ncgen, ncdump, and nccopy) now support an extended format for specifying a sequence of filters. The general form is __<filter>|<filter>..._. * The ncdump **_Filter** attribute now dumps a list of all the filters associated with a variable using the above new format. * Filter specifications can now use a filter name instead of number for filters known to the netcdf library, which in turn is taken from the HDF5 filter registration page. * New errors are defined: NC_EFILTER and NC_ENOFILTER. The latter is returned if an attempt is made to access an unknown filter. * Internally, the dispatch table has been extended to add a function to handle all of the filter functions. * New, filter-related, tests were added to nc_test4. * A new plugin was added to the plugins directory to help with testing. Notes: 1. The shuffle and fletcher32 filters are not part of the multifilter system. Misc. changes: 1. A debug module was added to libhdf5 to help catch error locations.
632 lines
13 KiB
C
632 lines
13 KiB
C
/* Copyright 2018, UCAR/Unidata See netcdf/COPYRIGHT file for copying
|
|
* and redistribution conditions.*/
|
|
/**
|
|
* @file
|
|
* @internal This file contains functions that return NC_ENOTNC4, for
|
|
* dispatch layers that only implement the classic model.
|
|
*
|
|
* @author Ed Hartnett
|
|
*/
|
|
|
|
#include "netcdf.h"
|
|
#include "netcdf_filter.h"
|
|
#include "ncdispatch.h"
|
|
#include "nc4internal.h"
|
|
|
|
/**
|
|
* @internal Not allowed for classic model.
|
|
*
|
|
* @param ncid Ignored.
|
|
* @param varid Ignored.
|
|
* @param id Ignored.
|
|
* @param nparams Ignored.
|
|
* @param parms Ignored.
|
|
*
|
|
* @return ::NC_ENOTNC4 Not allowed for classic model.
|
|
* @author Ed Hartnett
|
|
*/
|
|
int
|
|
NC_NOTNC4_def_var_filter(int ncid, int varid, unsigned int id, size_t nparams,
|
|
const unsigned int* parms)
|
|
{
|
|
return NC_ENOTNC4;
|
|
}
|
|
|
|
|
|
/**
|
|
* @internal Not allowed for classic model.
|
|
*
|
|
* @param parent_ncid Ignored.
|
|
* @param name Ignored.
|
|
* @param new_ncid Ignored.
|
|
*
|
|
* @return ::NC_ENOTNC4 Not allowed for classic model.
|
|
* @author Ed Hartnett
|
|
*/
|
|
int
|
|
NC_NOTNC4_def_grp(int parent_ncid, const char *name, int *new_ncid)
|
|
{
|
|
return NC_ENOTNC4;
|
|
}
|
|
|
|
/**
|
|
* @internal Not allowed for classic model.
|
|
*
|
|
* @param grpid Ignored.
|
|
* @param name Ignored.
|
|
*
|
|
* @return ::NC_ENOTNC4 Not allowed for classic model.
|
|
* @author Ed Hartnett
|
|
*/
|
|
int
|
|
NC_NOTNC4_rename_grp(int grpid, const char *name)
|
|
{
|
|
return NC_ENOTNC4;
|
|
}
|
|
|
|
/**
|
|
* @internal Not allowed for classic model.
|
|
*
|
|
* @param ncid Ignored.
|
|
* @param size Ignored.
|
|
* @param name Ignored.
|
|
* @param typeidp Ignored.
|
|
*
|
|
* @return ::NC_ENOTNC4 Not allowed for classic model.
|
|
* @author Ed Hartnett
|
|
*/
|
|
int
|
|
NC_NOTNC4_def_compound(int ncid, size_t size, const char *name, nc_type *typeidp)
|
|
{
|
|
return NC_ENOTNC4;
|
|
}
|
|
|
|
/**
|
|
* @internal Not allowed for classic model.
|
|
*
|
|
* @param ncid Ignored.
|
|
* @param typeid1 Ignored.
|
|
* @param name Ignored.
|
|
* @param offset Ignored.
|
|
* @param field Ignored.
|
|
*
|
|
* @return ::NC_ENOTNC4 Not allowed for classic model.
|
|
* @author Ed Hartnett
|
|
*/
|
|
int
|
|
NC_NOTNC4_insert_compound(int ncid, nc_type typeid1, const char *name, size_t offset,
|
|
nc_type field_typeid)
|
|
{
|
|
return NC_ENOTNC4;
|
|
}
|
|
|
|
/**
|
|
* @internal Not allowed for classic model.
|
|
*
|
|
* @param ncid Ignored.
|
|
* @param typeid1 Ignored.
|
|
* @param name Ignored.
|
|
* @param offset Ignored.
|
|
* @param field Ignored.
|
|
* @param ndims Ignored.
|
|
* @param dim Ignored.
|
|
*
|
|
* @return ::NC_ENOTNC4 Not allowed for classic model.
|
|
* @author Ed Hartnett
|
|
*/
|
|
extern int
|
|
NC_NOTNC4_insert_array_compound(int ncid, int typeid1, const char *name,
|
|
size_t offset, nc_type field_typeid,
|
|
int ndims, const int *dim_sizesp)
|
|
{
|
|
return NC_ENOTNC4;
|
|
}
|
|
|
|
/**
|
|
* @internal Not allowed for classic model.
|
|
*
|
|
* @param ncid Ignored.
|
|
* @param typeid1 Ignored.
|
|
* @param fieldid Ignored.
|
|
* @param name Ignored.
|
|
* @param offsetp Ignored.
|
|
* @param field Ignored.
|
|
* @param ndimsp Ignored.
|
|
* @param dim Ignored.
|
|
*
|
|
* @return ::NC_ENOTNC4 Not allowed for classic model.
|
|
* @author Ed Hartnett
|
|
*/
|
|
int
|
|
NC_NOTNC4_inq_compound_field(int ncid, nc_type typeid1, int fieldid, char *name,
|
|
size_t *offsetp, nc_type *field_typeidp, int *ndimsp,
|
|
int *dim_sizesp)
|
|
{
|
|
return NC_ENOTNC4;
|
|
}
|
|
|
|
/**
|
|
* @internal Not allowed for classic model.
|
|
*
|
|
* @param ncid Ignored.
|
|
* @param typeid1 Ignored.
|
|
* @param name Ignored.
|
|
* @param fieldidp Ignored.
|
|
*
|
|
* @return ::NC_ENOTNC4 Not allowed for classic model.
|
|
* @author Ed Hartnett
|
|
*/
|
|
int
|
|
NC_NOTNC4_inq_compound_fieldindex(int ncid, nc_type typeid1, const char *name, int *fieldidp)
|
|
{
|
|
return NC_ENOTNC4;
|
|
}
|
|
|
|
/* Opaque type. */
|
|
|
|
/**
|
|
* @internal Not allowed for classic model.
|
|
*
|
|
* @param ncid Ignored.
|
|
* @param datum Ignored.
|
|
* @param name Ignored.
|
|
* @param typeidp Ignored.
|
|
*
|
|
* @return ::NC_ENOTNC4 Not allowed for classic model.
|
|
* @author Ed Hartnett
|
|
*/
|
|
int
|
|
NC_NOTNC4_def_opaque(int ncid, size_t datum_size, const char *name,
|
|
nc_type *typeidp)
|
|
{
|
|
return NC_ENOTNC4;
|
|
}
|
|
|
|
/**
|
|
* @internal Not allowed for classic model.
|
|
*
|
|
* @param ncid Ignored.
|
|
* @param name Ignored.
|
|
* @param base_typeid Ignored.
|
|
* @param typeidp Ignored.
|
|
*
|
|
* @return ::NC_ENOTNC4 Not allowed for classic model.
|
|
* @author Ed Hartnett
|
|
*/
|
|
int
|
|
NC_NOTNC4_def_vlen(int ncid, const char *name, nc_type base_typeid,
|
|
nc_type *typeidp)
|
|
{
|
|
return NC_ENOTNC4;
|
|
}
|
|
|
|
/**
|
|
* @internal Not allowed for classic model.
|
|
*
|
|
* @param ncid Ignored.
|
|
* @param base_typeid Ignored.
|
|
* @param name Ignored.
|
|
* @param typeidp Ignored.
|
|
*
|
|
* @return ::NC_ENOTNC4 Not allowed for classic model.
|
|
* @author Ed Hartnett
|
|
*/
|
|
int
|
|
NC_NOTNC4_def_enum(int ncid, nc_type base_typeid, const char *name,
|
|
nc_type *typeidp)
|
|
{
|
|
return NC_ENOTNC4;
|
|
}
|
|
|
|
|
|
/**
|
|
* @internal Not allowed for classic model.
|
|
*
|
|
* @param ncid Ignored.
|
|
* @param xtype Ignored.
|
|
* @param value Ignored.
|
|
* @param identifier Ignored.
|
|
*
|
|
* @return ::NC_ENOTNC4 Not allowed for classic model.
|
|
* @author Ed Hartnett
|
|
*/
|
|
int
|
|
NC_NOTNC4_inq_enum_ident(int ncid, nc_type xtype, long long value, char *identifier)
|
|
{
|
|
return NC_ENOTNC4;
|
|
}
|
|
|
|
/**
|
|
* @internal Not allowed for classic model.
|
|
*
|
|
* @param ncid Ignored.
|
|
* @param typeid1 Ignored.
|
|
* @param idx Ignored.
|
|
* @param identifier Ignored.
|
|
* @param value Ignored.
|
|
*
|
|
* @return ::NC_ENOTNC4 Not allowed for classic model.
|
|
* @author Ed Hartnett
|
|
*/
|
|
int
|
|
NC_NOTNC4_inq_enum_member(int ncid, nc_type typeid1, int idx, char *identifier,
|
|
void *value)
|
|
{
|
|
return NC_ENOTNC4;
|
|
}
|
|
|
|
/**
|
|
* @internal Not allowed for classic model.
|
|
*
|
|
* @param ncid Ignored.
|
|
* @param typeid1 Ignored.
|
|
* @param identifier Ignored.
|
|
* @param value Ignored.
|
|
*
|
|
* @return ::NC_ENOTNC4 Not allowed for classic model.
|
|
* @author Ed Hartnett
|
|
*/
|
|
int
|
|
NC_NOTNC4_insert_enum(int ncid, nc_type typeid1, const char *identifier,
|
|
const void *value)
|
|
{
|
|
return NC_ENOTNC4;
|
|
}
|
|
|
|
/**
|
|
* @internal Not allowed for classic model.
|
|
*
|
|
* @param ncid Ignored.
|
|
* @param typeid1 Ignored.
|
|
* @param vlen_element Ignored.
|
|
* @param len Ignored.
|
|
* @param data Ignored.
|
|
*
|
|
* @return ::NC_NOERR No error.
|
|
* @author Ed Hartnett
|
|
*/
|
|
int
|
|
NC_NOTNC4_put_vlen_element(int ncid, int typeid1, void *vlen_element,
|
|
size_t len, const void *data)
|
|
{
|
|
return NC_ENOTNC4;
|
|
}
|
|
|
|
/**
|
|
* @internal Not allowed for classic model.
|
|
*
|
|
* @param ncid Ignored.
|
|
* @param typeid1 Ignored.
|
|
* @param vlen_element Ignored.
|
|
* @param len Ignored.
|
|
* @param data Ignored.
|
|
*
|
|
* @return ::NC_ENOTNC4 Not allowed for classic model.
|
|
* @author Ed Hartnett
|
|
*/
|
|
int
|
|
NC_NOTNC4_get_vlen_element(int ncid, int typeid1, const void *vlen_element,
|
|
size_t *len, void *data)
|
|
{
|
|
return NC_ENOTNC4;
|
|
}
|
|
|
|
/**
|
|
* @internal Not allowed for classic model.
|
|
*
|
|
* @param ncid Ignored.
|
|
* @param varid Ignored.
|
|
* @param size Ignored.
|
|
* @param nelems Ignored.
|
|
* @param preemption Ignored.
|
|
*
|
|
* @return ::NC_ENOTNC4 Not allowed for classic model.
|
|
* @author Ed Hartnett
|
|
*/
|
|
int
|
|
NC_NOTNC4_set_var_chunk_cache(int ncid, int varid, size_t size, size_t nelems,
|
|
float preemption)
|
|
{
|
|
return NC_ENOTNC4;
|
|
}
|
|
|
|
/**
|
|
* @internal Not allowed for classic model.
|
|
*
|
|
* @param ncid Ignored.
|
|
* @param varid Ignored.
|
|
* @param sizep Ignored.
|
|
* @param nelemsp Ignored.
|
|
* @param preemptionp Ignored.
|
|
*
|
|
* @return ::NC_ENOTNC4 Not allowed for classic model.
|
|
* @author Ed Hartnett
|
|
*/
|
|
int
|
|
NC_NOTNC4_get_var_chunk_cache(int ncid, int varid, size_t *sizep,
|
|
size_t *nelemsp, float *preemptionp)
|
|
{
|
|
return NC_ENOTNC4;
|
|
}
|
|
|
|
/**
|
|
* @internal Not allowed for classic model.
|
|
*
|
|
* @param ncid Ignored.
|
|
* @param varid Ignored.
|
|
* @param shuffle Ignored.
|
|
* @param deflate Ignored.
|
|
* @param deflate_level Ignored.
|
|
*
|
|
* @return ::NC_ENOTNC4 Not allowed for classic model.
|
|
* @author Ed Hartnett, Dennis Heimbigner
|
|
*/
|
|
int
|
|
NC_NOTNC4_def_var_deflate(int ncid, int varid, int shuffle, int deflate,
|
|
int deflate_level)
|
|
{
|
|
return NC_ENOTNC4;
|
|
}
|
|
|
|
/**
|
|
* @internal Not allowed for classic model.
|
|
*
|
|
* @param ncid Ignored.
|
|
* @param varid Ignored.
|
|
* @param fletcher32 Ignored.
|
|
*
|
|
* @return ::NC_ENOTNC4 Not allowed for classic model.
|
|
* @author Ed Hartnett, Dennis Heimbigner
|
|
*/
|
|
int
|
|
NC_NOTNC4_def_var_fletcher32(int ncid, int varid, int fletcher32)
|
|
{
|
|
return NC_ENOTNC4;
|
|
}
|
|
|
|
/**
|
|
* @internal Not allowed for classic model.
|
|
*
|
|
* @param ncid Ignored.
|
|
* @param varid Ignored.
|
|
* @param contiguous Ignored.
|
|
* @param chunksizesp Ignored.
|
|
*
|
|
* @return ::NC_ENOTNC4 Not allowed for classic model.
|
|
* @author Ed Hartnett, Dennis Heimbigner
|
|
*/
|
|
int
|
|
NC_NOTNC4_def_var_chunking(int ncid, int varid, int contiguous, const size_t *chunksizesp)
|
|
{
|
|
return NC_EPERM;
|
|
}
|
|
|
|
|
|
/**
|
|
* @internal Not allowed for classic model.
|
|
*
|
|
* @param ncid Ignored.
|
|
* @param varid Ignored.
|
|
* @param endianness Ignored.
|
|
*
|
|
* @return ::NC_ENOTNC4 Not allowed for classic model.
|
|
* @author Ed Hartnett
|
|
*/
|
|
int
|
|
NC_NOTNC4_def_var_endian(int ncid, int varid, int endianness)
|
|
{
|
|
return NC_ENOTNC4;
|
|
}
|
|
|
|
/**
|
|
* @internal Not allowed for classic model.
|
|
*
|
|
* @param ncid Ignored.
|
|
* @param varid Ignored.
|
|
* @param par_access Ignored.
|
|
*
|
|
* @return ::NC_ENOTNC4 Not allowed for classic model.
|
|
* @author Ed Hartnett, Dennis Heimbigner
|
|
*/
|
|
int
|
|
NC_NOTNC4_var_par_access(int ncid, int varid, int par_access)
|
|
{
|
|
return NC_ENOTNC4;
|
|
}
|
|
|
|
/**
|
|
* @internal Not allowed for classic model.
|
|
*
|
|
* @param ncid Ignored.
|
|
* @param name Ignored.
|
|
* @param grp_ncid Ignored.
|
|
*
|
|
* @return ::NC_ENOTNC4 Not allowed for classic model.
|
|
* @author Ed Hartnett
|
|
*/
|
|
int
|
|
NC_NOTNC4_inq_ncid(int ncid, const char *name, int *grp_ncid)
|
|
{
|
|
return NC_ENOTNC4;
|
|
}
|
|
|
|
/**
|
|
* @internal Not allowed for classic model.
|
|
*
|
|
* @param ncid Ignored.
|
|
* @param numgrps Ignored.
|
|
* @param ncids Ignored.
|
|
*
|
|
* @return ::NC_ENOTNC4 Not allowed for classic model.
|
|
* @author Ed Hartnett
|
|
*/
|
|
int
|
|
NC_NOTNC4_inq_grps(int ncid, int *numgrps, int *ncids)
|
|
{
|
|
return NC_ENOTNC4;
|
|
}
|
|
|
|
/**
|
|
* @internal Not allowed for classic model.
|
|
*
|
|
* @param ncid Ignored.
|
|
* @param name Ignored.
|
|
|
|
* @return ::NC_ENOTNC4 Not allowed for classic model.
|
|
* @author Ed Hartnett
|
|
*/
|
|
int
|
|
NC_NOTNC4_inq_grpname(int ncid, char *name)
|
|
{
|
|
return NC_ENOTNC4;
|
|
}
|
|
|
|
/**
|
|
* @internal Not allowed for classic model.
|
|
*
|
|
* @param ncid Ignored.
|
|
* @param lenp Ignored.
|
|
* @param full_name Ignored.
|
|
*
|
|
* @return ::NC_ENOTNC4 Not allowed for classic model.
|
|
* @author Ed Hartnett
|
|
*/
|
|
int
|
|
NC_NOTNC4_inq_grpname_full(int ncid, size_t *lenp, char *full_name)
|
|
{
|
|
return NC_ENOTNC4;
|
|
}
|
|
|
|
/**
|
|
* @internal Not allowed for classic model.
|
|
*
|
|
* @param ncid Ignored.
|
|
* @param parent_ncid Ignored.
|
|
*
|
|
* @return ::NC_ENOTNC4 Not allowed for classic model.
|
|
* @author Ed Hartnett
|
|
*/
|
|
int
|
|
NC_NOTNC4_inq_grp_parent(int ncid, int *parent_ncid)
|
|
{
|
|
return NC_ENOTNC4;
|
|
}
|
|
|
|
/**
|
|
* @internal Not allowed for classic model.
|
|
*
|
|
* @param ncid Ignored.
|
|
* @param full_name Ignored.
|
|
* @param grp_ncid Ignored.
|
|
*
|
|
* @return ::NC_ENOTNC4 Not allowed for classic model.
|
|
* @author Ed Hartnett
|
|
*/
|
|
int
|
|
NC_NOTNC4_inq_grp_full_ncid(int ncid, const char *full_name, int *grp_ncid)
|
|
{
|
|
return NC_ENOTNC4;
|
|
}
|
|
|
|
/**
|
|
* @internal Not allowed for classic model.
|
|
*
|
|
* @param ncid Ignored.
|
|
* @param nvars Ignored.
|
|
* @param varids Ignored.
|
|
*
|
|
* @return ::NC_ENOTNC4 Not allowed for classic model.
|
|
* @author Ed Hartnett
|
|
*/
|
|
int
|
|
NC_NOTNC4_inq_varids(int ncid, int *nvars, int *varids)
|
|
{
|
|
return NC_ENOTNC4;
|
|
}
|
|
|
|
/**
|
|
* @internal Not allowed for classic model.
|
|
*
|
|
* @param ncid Ignored.
|
|
* @param ndims Ignored.
|
|
* @param dimids Ignored.
|
|
* @param include_parents Ignored.
|
|
*
|
|
* @return ::NC_ENOTNC4 Not allowed for classic model.
|
|
* @author Ed Hartnett
|
|
*/
|
|
int
|
|
NC_NOTNC4_inq_dimids(int ncid, int *ndims, int *dimids, int include_parents)
|
|
{
|
|
return NC_ENOTNC4;
|
|
}
|
|
|
|
/**
|
|
* @internal Not allowed for classic model.
|
|
*
|
|
* @param ncid Ignored.
|
|
* @param ntypes Ignored.
|
|
* @param typeids Ignored.
|
|
*
|
|
* @return ::NC_ENOTNC4 Not allowed for classic model.
|
|
* @author Ed Hartnett
|
|
*/
|
|
int
|
|
NC_NOTNC4_inq_typeids(int ncid, int *ntypes, int *typeids)
|
|
{
|
|
return NC_ENOTNC4;
|
|
}
|
|
|
|
/**
|
|
* @internal Not allowed for classic model.
|
|
*
|
|
* @param ncid Ignored.
|
|
* @param typeid1 Ignored.
|
|
* @param name Ignored.
|
|
* @param size Ignored.
|
|
* @param base_nc_typep Ignored.
|
|
* @param nfieldsp Ignored.
|
|
* @param classp Ignored.
|
|
*
|
|
* @return ::NC_ENOTNC4 Not allowed for classic model.
|
|
* @author Ed Hartnett
|
|
*/
|
|
int
|
|
NC_NOTNC4_inq_user_type(int ncid, nc_type typeid1, char *name, size_t *size,
|
|
nc_type *base_nc_typep, size_t *nfieldsp, int *classp)
|
|
{
|
|
return NC_ENOTNC4;
|
|
}
|
|
|
|
/**
|
|
* @internal Get the id of a type from the name.
|
|
*
|
|
* @param ncid Ignored.
|
|
* @param name Ignored.
|
|
* @param typeidp Ignored.
|
|
*
|
|
* @return ::NC_ENOTNC4 Not allowed for classic model.
|
|
* @author Ed Hartnett
|
|
*/
|
|
int
|
|
NC_NOTNC4_inq_typeid(int ncid, const char *name, nc_type *typeidp)
|
|
{
|
|
return NC_ENOTNC4;
|
|
}
|
|
|
|
/**
|
|
* @internal Carry out one of several filter actions
|
|
*
|
|
* @param ncid Containing group id
|
|
* @param varid Containing variable id
|
|
* @param action Action to perform
|
|
*
|
|
* @return ::NC_ENOTNC4 Not allowed for classic model.
|
|
* @author D. Heimbigner
|
|
*/
|
|
int
|
|
NC_NOTNC4_filter_actions(int ncid, int varid, int action, struct NC_Filterobject* spec)
|
|
{
|
|
return NC_ENOTNC4;
|
|
}
|