mirror of
https://github.com/Unidata/netcdf-c.git
synced 2024-12-03 08:01:25 +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.
84 lines
1.9 KiB
C
84 lines
1.9 KiB
C
/* Copyright 2005-2018 University Corporation for Atmospheric
|
|
Research/Unidata. */
|
|
/**
|
|
* @file
|
|
* @internal This header file contains libsrc4 dispatch
|
|
* initialization, user-defined format, and logging prototypes and
|
|
* macros.
|
|
*
|
|
* @author Dennis Heimbigner, Ed Hartnett
|
|
*/
|
|
|
|
#include "config.h"
|
|
#include <stdlib.h>
|
|
#include "netcdf.h"
|
|
#include "nc4internal.h"
|
|
#include "nc4dispatch.h"
|
|
#include "nc.h"
|
|
|
|
/* If user-defined formats are in use, we need to declare their
|
|
* dispatch tables. */
|
|
#ifdef USE_UDF0
|
|
extern NC_Dispatch UDF0_DISPATCH;
|
|
#endif /* USE_UDF0 */
|
|
#ifdef USE_UDF1
|
|
extern NC_Dispatch UDF1_DISPATCH;
|
|
#endif /* USE_UDF1 */
|
|
|
|
#ifdef USE_NETCDF4
|
|
/* Pointers to dispatch tables for user-defined formats. */
|
|
extern NC_Dispatch *UDF0_dispatch_table;
|
|
extern NC_Dispatch *UDF1_dispatch_table;
|
|
#endif /* USE_NETCDF4 */
|
|
|
|
|
|
|
|
/**
|
|
* @internal Initialize netCDF-4. If user-defined format(s) have been
|
|
* specified in configure, load their dispatch table(s).
|
|
*
|
|
* @return ::NC_NOERR No error.
|
|
* @author Dennis Heimbigner
|
|
*/
|
|
int
|
|
NC4_initialize(void)
|
|
{
|
|
int ret = NC_NOERR;
|
|
|
|
#ifdef USE_UDF0
|
|
/* If user-defined format 0 was specified during configure, set up
|
|
* it's dispatch table. */
|
|
if ((ret = nc_def_user_format(NC_UDF0, UDF0_DISPATCH_FUNC, NULL)))
|
|
return ret;
|
|
#endif /* USE_UDF0 */
|
|
|
|
#ifdef USE_UDF1
|
|
/* If user-defined format 0 was specified during configure, set up
|
|
* it's dispatch table. */
|
|
if ((ret = nc_def_user_format(NC_UDF1F, &UDF1_DISPATCH_FUNC, NULL)))
|
|
return ret;
|
|
#endif /* USE_UDF0 */
|
|
|
|
#ifdef LOGGING
|
|
if(getenv(NCLOGLEVELENV) != NULL) {
|
|
char* slevel = getenv(NCLOGLEVELENV);
|
|
long level = atol(slevel);
|
|
if(level >= 0)
|
|
nc_set_log_level((int)level);
|
|
}
|
|
#endif
|
|
return ret;
|
|
}
|
|
|
|
/**
|
|
* @internal Finalize netCDF-4.
|
|
*
|
|
* @return ::NC_NOERR No error.
|
|
* @author Dennis Heimbigner
|
|
*/
|
|
int
|
|
NC4_finalize(void)
|
|
{
|
|
return NC_NOERR;
|
|
}
|