Data Structures¶

struct gribfield
Struct for GRIB2 field.

Macros¶

#define G2_ADD_MSG_COMPLETE -2
GRIB message already complete. #define G2_ADD_MSG_INIT -1
GRIB message was not initialized - call g2_create() first. #define G2_ADDFIELD_BAD_BITMAP -8
In g2_addfield() no bitmap in the GRIB message. #define G2_ADDFIELD_BAD_DRT -7
In g2_addfield() unsupported Data Representationi Template. #define G2_ADDFIELD_BAD_GDS -6
In g2_addfield() section 3 (GDS) not previously defined in message. #define G2_ADDFIELD_BAD_GDT -9
In g2_addfield() GDT of one of 5.50 through 5.53 required when using DRT 5.51. #define G2_ADDFIELD_BAD_PDT -5
In g2_addfield() could not find requested Product Definition Template. #define G2_ADDFIELD_ERR -10
In g2_addfield() error packing data field. #define G2_ADDGRID_BAD_GDT -5
In g2_addgrid() Could not find requested Grid Definition Template. #define G2_AEC_ENABLED 1
Decoding/encoding AEC/CCSDS is enabled. #define G2_BAD_SEC -4
Previous Section was unexpected. #define G2_BAD_SEC_COUNTS -3
Sum of Section byte counts doesn't add to total byte count. #define G2_CREATE_GRIB_VERSION -1
Wrong GRIB version for g2_create(), must be 2. #define G2_GETFLD_BAD_END 7
g2_getfld() didn't find '7777' at end of message. #define G2_GETFLD_BAD_SEC1 15
Error in g2_getfld() unpacking section 1. #define G2_GETFLD_BAD_SEC2 16
Error in g2_getfld() unpacking section 2. #define G2_GETFLD_BAD_SEC3 10
Error in g2_getfld() unpacking section 3. #define G2_GETFLD_BAD_SEC4 11
Error in g2_getfld() unpacking section 4. #define G2_GETFLD_BAD_SEC5 12
Error in g2_getfld() unpacking section 5. #define G2_GETFLD_BAD_SEC6 13
Error in g2_getfld() unpacking section 6. #define G2_GETFLD_BAD_SEC7 14
Error in g2_getfld() unpacking section 7. #define G2_GETFLD_GRIB_VERSION 2
Wrong GRIB version for g2_getfld(), must be 2. #define G2_GETFLD_INVAL 3
g2_getfld() data field request number was not positive. #define G2_GETFLD_INVAL_SEC 8
g2_getfld() encountered unrecognized section. #define G2_GETFLD_NO_BITMAP 17
In g2_getfld() previous bitmap specified, yet none exists. #define G2_GETFLD_NO_DRT 9
In g2_getfld(), Data Representation Template not implemented. #define G2_GETFLD_NO_GRIB 1
g2_getfld() can't find beginning characters 'GRIB'. #define G2_GETFLD_WRONG_END 4
g2_info() found '7777' not where expected. #define G2_GETFLD_WRONG_NFLDS 6
In g2_getfld() message did not contain the requested number of data fields. #define G2_GRIBEND_MSG_INIT -1
In g2_gribend() GRIB message was not initialized - call g2_create() first. #define G2_INFO_BAD_END 5
g2_info() didn't find '7777' at end of message. #define G2_INFO_GRIB_VERSION 2
Wrong GRIB version for g2_info(), must be 2. #define G2_INFO_INVAL_SEC 6
g2_info() found invalid section number. #define G2_INFO_NO_GRIB 1
g2_info() can't find beginning characters 'GRIB'. #define G2_INFO_NO_SEC1 3
g2_info() can't find section 1. #define G2_INFO_WRONG_END 4
g2_info() found '7777' not where expected. #define G2_JASPER_DECODE -3
In dec_jpeg2000() error decoding image with jasper. #define G2_JASPER_DECODE_COLOR -5
In dec_jpeg2000() decoded image had multiple color components. #define G2_JASPER_ENCODE -3
In enc_jpeg2000() error encoding image with jasper. #define G2_JASPER_INIT -2
In enc_jpeg2000()/dec_jpeg2000() error initializing jasper library. #define G2_JPCUNPACK_MEM 1
In jpcunpack() or other unpack function: out of memory. #define G2_JPEG2000_ENABLED 1
Decoding/encoding JPEG2000 is enabled. #define G2_NO_ERROR 0
Function succeeded. #define G2_PNG_ENABLED 1
Decoding/encoding PNG is enabled. #define G2_SPECUNPACK_TYPE -3
In specunpack() Can't handle 64 or 128 bit floats. #define G2_UNPACK3_BAD_GDT 5
In g2_unpack3(), undefined Grid Definition Template. #define G2_UNPACK4_BAD_PDT 5
In g2_unpack4(), undefined Product Definition Template. #define G2_UNPACK5_BAD_DRT 7
In g2_unpack5(), undefined Data Representation Template. #define G2_UNPACK6_BAD_BITMAP 4
In g2_unpack6(), unrecognized pre-defined bit-map. #define G2_UNPACK7_BAD_DRT 4
In g2_unpack7(), unrecognized Data Representation Template. #define G2_UNPACK7_CORRUPT_SEC 7
In g2_unpack7(), corrupt section 7. #define G2_UNPACK7_WRONG_GDT 5
In g2_unpack7(), need one of GDT 3.50 through 3.53 to decode DRT 5.51. #define G2_UNPACK_BAD_SEC 2
Bad section number in unpacking function. #define G2_UNPACK_NO_MEM 6
Error allocating memory in unpack function. #define G2C_AEC_DRS_TEMPLATE_LEN 8
Length of the idrstmpl array for AEC packing. #define G2C_BYTE 1
signed 1 byte integer #define G2C_CHAR 2
ISO/ASCII character. #define G2C_CLOBBER 0x0000
Destroy existing file. #define G2C_DOUBLE 6
double precision floating point number #define G2C_EAEC (-74)
Error encoding/decoding AEC data. #define G2C_EBADEND (-65)
End of message in wrong place. #define G2C_EBADID (-55)
Bad ID. #define G2C_EBADSECTION (-66)
Invalid section number. #define G2C_EBADTEMPLATE (-70)
Template problem. #define G2C_EBADTYPE (-73)
Type not found. #define G2C_ECSV (-75)
CSV error. #define G2C_EFILE (-54)
File I/O error. #define G2C_EINVAL (-53)
Invalid input. #define G2C_EJPEG (-67)
Error encoding/decoding JPEG data. #define G2C_EMSG (-58)
Error decoding GRIB message. #define G2C_EMSGCOMPLETE (-51)
GRIB message already complete. #define G2C_ENAMETOOLONG (-52)
Name too long. #define G2C_ENOEND (-64)
Cannot find end of GRIB message. #define G2C_ENOMEM (-57)
Out of memory. #define G2C_ENOMSG (-59)
No GRIB message found. #define G2C_ENOPARAM (-71)
Parameter not found. #define G2C_ENOPRODUCT (-72)
Product not found. #define G2C_ENOSECTION (-63)
Cannot find section. #define G2C_ENOTEMPLATE (-69)
Template not found. #define G2C_ENOTFOUND (-61)
Table or entry not found. #define G2C_ENOTGRIB (-50)
GRIB header not found. #define G2C_ENOTGRIB2 (-62)
Not GRIB 2. #define G2C_EPNG (-68)
Error encoding/decoding PNG data. #define G2C_ERROR 1
General error code, returned for some test errors. #define G2C_ETOOMANYFILES (-56)
Trying to open too many files. #define G2C_EXML (-60)
XML error. #define G2C_FLOAT 5
single precision floating point number #define G2C_INT 4
signed 4 byte integer #define G2C_INT64 10
signed 8-byte int #define G2C_JASPER_MAX_MEM
Maximum size for the Jasper memory buffer. #define G2C_JPEG_DRS_TEMPLATE_LEN 7
Length of the idrstmpl array for JPEG packing. #define G2C_LARGE_FILE_INDEX 0x0008
Create a large file index. #define G2C_MAX_DRS_TEMPLATE 10
Maximum number of DRS templates. #define G2C_MAX_DRS_TEMPLATE_MAPLEN 18
Maximum DRS template map length. #define G2C_MAX_FILES 3
Maximum number of open files. #define G2C_MAX_GDS_TEMPLATE 31
Maximum number of grid templates. #define G2C_MAX_GDS_TEMPLATE_MAPLEN 28
Maximum grid template map length. #define G2C_MAX_GRIB_CODE_LEN 20
Maximum length of code. #define G2C_MAX_GRIB_DESC_LEN 512
Maximum length of code description. #define G2C_MAX_GRIB_LEVEL_DESC_LEN 40
Maximum length of level description. #define G2C_MAX_GRIB_STATUS_LEN 40
Maximum length of code status. #define G2C_MAX_GRIB_TITLE_LEN 200
Maximum length of code table title. #define G2C_MAX_NAME 1024
Maximum length of a name. #define G2C_MAX_NOAA_ABBREV_LEN 8
Maximum length of a NOAA abbreviation of a parameter. #define G2C_MAX_NOAA_PARAM_LINE_LEN 120
Maximum length of a line in the NOAA abbreviation CSV file. #define G2C_MAX_NOAA_PARAMS 2000
Maximum number of known parameters with NOAA abbreviations. #define G2C_MAX_NUM_SECTIONS 1024
Maximum number of sections that can be handled in one message. #define G2C_MAX_PDS_TEMPLATE 47
Maximum number of PDS templates. #define G2C_MAX_PDS_TEMPLATE_MAPLEN 45
Maximum template map length. #define G2C_NOCLOBBER 0x0004
Don't destroy existing file. #define G2C_NOERROR 0
No error. #define G2C_NOWRITE 0x0000
Set read-only access for g2c_open(). #define G2C_PNG_DRS_TEMPLATE_LEN 5
Length of the idrstmpl array for PNG packing. #define G2C_SECTION0_ARRAY_LEN 3
Length of section 0 array. #define G2C_SECTION0_BYTES 16
Number of bytes in section 0. #define G2C_SECTION0_LEN 3
Length of section 0 array. #define G2C_SECTION1_ARRAY_LEN 13
Length of section 1 array. #define G2C_SECTION1_BYTES 21
Number of bytes in section 1 (not including reserved, optional data at the end of the section). #define G2C_SECTION1_LEN 13
Length of section 1 array. #define G2C_SHORT 3
signed 2 byte integer #define G2C_UBYTE 7
unsigned 1 byte int #define G2C_UINT 9
unsigned 4-byte int #define G2C_UINT64 11
unsigned 8-byte int #define G2C_USHORT 8
unsigned 2-byte int #define G2C_VERSION '2.0.0'
Current version of NCEPLIBS-g2c library. #define G2C_WRITE 0x0001
Set read-write access for g2c_open().

Typedefs¶

typedef float g2float
Float type. typedef int64_t g2int
Long integer type. typedef uint64_t g2intu
Unsigned long integer type. typedef struct gribfield gribfield
Struct for GRIB field.

Functions¶

g2int g2_addfield (unsigned char *cgrib, g2int ipdsnum, g2int *ipdstmpl, float *coordlist, g2int numcoord, g2int idrsnum, g2int *idrstmpl, float *fld, g2int ngrdpts, g2int ibmap, g2int *bmap)
Pack sections 4 through 7 and adds them to a GRIB2 message. g2int g2_addgrid (unsigned char *cgrib, g2int *igds, g2int *igdstmpl, g2int *ideflist, g2int idefnum)
Packs a Grid Definition Section (Section 3) and adds it to a GRIB2 message. g2int g2_addlocal (unsigned char *cgrib, unsigned char *csec2, g2int lcsec2)
Adds a Local Use Section (Section 2) to a GRIB2 message. g2int g2_create (unsigned char *cgrib, g2int *listsec0, g2int *listsec1)
Initialize a new GRIB2 message and pack GRIB2 Section 0 (Indicator Section) and Section 1 (Identification Section). void g2_free (gribfield *gfld)
Free memory that was allocated for struct gribfield. g2int g2_getfld (unsigned char *cgrib, g2int ifldnum, g2int unpack, g2int expand, gribfield **gfld)
Return all the metadata, template values, bit-map (if applicable), and the unpacked data for a data field. g2int g2_gribend (unsigned char *cgrib)
Finalize a GRIB2 message after all grids and fields have been added. g2int g2_info (unsigned char *cgrib, g2int *listsec0, g2int *listsec1, g2int *numfields, g2int *numlocal)
Search through a GRIB2 message and return the number of gridded fields found in the message and the number (and maximum size) of Local Use Sections. g2int g2_unpack1 (unsigned char *cgrib, g2int *iofst, g2int **ids, g2int *idslen)
Unpacks Section 1 - Identification Section of a GRIB2 message. g2int g2_unpack2 (unsigned char *cgrib, g2int *iofst, g2int *lencsec2, unsigned char **csec2)
Unpack Section 2 (Local Use Section) of a GRIB2 message. g2int g2_unpack3 (unsigned char *cgrib, g2int *iofst, g2int **igds, g2int **igdstmpl, g2int *mapgridlen, g2int **ideflist, g2int *idefnum)
Unpack Section 3 (Grid Definition Section) of a GRIB2 message. g2int g2_unpack4 (unsigned char *cgrib, g2int *iofst, g2int *ipdsnum, g2int **ipdstmpl, g2int *mappdslen, float **coordlist, g2int *numcoord)
Unpack Section 4 (Product Definition Section) of a GRIB2 message. g2int g2_unpack5 (unsigned char *cgrib, g2int *iofst, g2int *ndpts, g2int *idrsnum, g2int **idrstmpl, g2int *mapdrslen)
Unpack Section 5 (Data Representation Section) of a GRIB2 message. g2int g2_unpack6 (unsigned char *cgrib, g2int *iofst, g2int ngpts, g2int *ibmap, g2int **bmap)
Unpack Section 6 (Bit-Map Section) of a GRIB2 message. g2int g2_unpack7 (unsigned char *cgrib, g2int *iofst, g2int igdsnum, g2int *igdstmpl, g2int idrsnum, g2int *idrstmpl, g2int ndpts, float **fld)
This subroutine unpacks Section 7 (Data Section) of a GRIB2 message. int g2c_aecpackd (double *fld, size_t width, size_t height, int *idrstmpl, unsigned char *cpack, size_t *lcpack)
This function packs up a double array into a AEC code stream. int g2c_aecpackf (float *fld, size_t width, size_t height, int *idrstmpl, unsigned char *cpack, size_t *lcpack)
This function packs up a float array into a AEC code stream. int g2c_aecunpackd (unsigned char *cpack, size_t len, int *idrstmpl, size_t ndpts, double *fld)
Unpack AEC compressed data into an array of doubles, using info from the GRIB2 Data Representation Template 5.42. int g2c_aecunpackf (unsigned char *cpack, size_t len, int *idrstmpl, size_t ndpts, float *fld)
Unpack AEC compressed data into an array of floats, using info from the GRIB2 Data Representation Template 5.42. int g2c_close (int g2cid)
Close a GRIB2 file, freeing resources. int g2c_compare (int g2cid1, int g2cid2)
Compare the metadata of two open GRIB2 files. int g2c_csv_init ()
Initialize tables from 'CodeFlag.txt'. int g2c_dec_jpeg2000 (char *injpc, size_t bufsize, int *outfld)
Decode a JPEG2000 code stream specified in the JPEG2000 Part-1 standard (i.e., ISO/IEC 15444-1) using JasPer Software. int g2c_degrib2 (int g2cid, const char *fileout)
Write a summary file like the degrib2 utility. int g2c_enc_jpeg2000 (unsigned char *cin, int width, int height, int nbits, int ltype, int ratio, int retry, char *outjpc, size_t jpclen)
Encode a grayscale image into a JPEG2000 code stream specified in the JPEG2000 Part-1 standard (i.e., ISO/IEC 15444-1) using JasPer Software. int g2c_find_desc (char *title, int code, char *desc)
Given a table title and an integer code, find a description. int g2c_find_desc_str (char *title, char *code, char *desc)
Given a table title and a code, find a description. int g2c_find_msg2 (int g2cid, size_t skip_bytes, size_t max_bytes, size_t *bytes_to_msg, size_t *bytes_in_msg)
Search a file for the next GRIB1 or GRIB2 message. void g2c_free_tables ()
Free table memory. void g2c_gbit_int (unsigned char *in, int *iout, int iskip, int nbits)
Extract arbitrary size values from a packed bit string, right justifying each value in the unpacked iout array. int g2c_gbits_int (unsigned char *in, int *iout, int iskip, int nbits, int nskip, int n)
Extract arbitrary size values from a packed bit string, right justifying each value in the unpacked iout array. int g2c_get_drs_template (int drs_template_num, int *maplen, int *map, int *needext)
Get DRS template information. int g2c_get_grid_template (int grid_template_num, int *maplen, int *map, int *needext)
Get grid template information. int g2c_get_grid_template_extension (int grid_template_num, int *g2c_template, int *extlen, int *ext)
Get grid template extension information. int g2c_get_msg (int g2cid, size_t skip_bytes, size_t max_bytes, size_t *bytes_to_msg, size_t *bytes_in_msg, unsigned char **cbuf)
Search a file for the next GRIB1 or GRIB2 message, and read it, allocating space in memory to hold the message. int g2c_get_pds_template (int pds_template_num, int *maplen, int *map, int *needext)
Get PDS template information. int g2c_get_pds_template_extension (int pds_template_num, int *g2c_template, int *extlen, int *ext)
Get pds template extension information. int g2c_get_prod (int g2cid, int msg_num, int prod_num, int *num_data_points, float *data)
Read the data for a product. int g2c_inq (int g2cid, int *num_msg)
Learn about a GRIB2 file. int g2c_inq_dim (int g2cid, int msg_num, int prod_num, int dim_num, size_t *len, char *name, float *val)
Learn about the one of the dimensions of a GRIB2 product. int g2c_inq_msg (int g2cid, int msg_num, unsigned char *discipline, int *num_fields, int *num_local, short *center, short *subcenter, unsigned char *master_version, unsigned char *local_version)
Learn about a GRIB2 message. int g2c_inq_msg_time (int g2cid, int msg_num, unsigned char *sig_ref_time, short *year, unsigned char *month, unsigned char *day, unsigned char *hour, unsigned char *minute, unsigned char *second)
Learn about the date/time information in a GRIB2 message. int g2c_inq_prod (int g2cid, int msg_num, int prod_num, int *pds_template_len, long long int *pds_template, int *gds_template_len, long long int *gds_template, int *drs_template_len, long long int *drs_template)
Inquire about a product. int g2c_jpcpackd (double *fld, size_t width, size_t height, int *idrstmpl, unsigned char *cpack, size_t *lcpack)
This function packs up a double array into a JPEG2000 code stream. int g2c_jpcpackf (float *fld, size_t width, size_t height, int *idrstmpl, unsigned char *cpack, size_t *lcpack)
This function packs up a float array into a JPEG2000 code stream. int g2c_jpcunpackd (unsigned char *cpack, size_t len, int *idrstmpl, size_t ndpts, double *fld)
Unpack JPEG2000 compressed data into an array of doubles, using info from the GRIB2 Data Representation Template 5.40 or 5.40000. int g2c_jpcunpackf (unsigned char *cpack, size_t len, int *idrstmpl, size_t ndpts, float *fld)
Unpack JPEG2000 compressed data into an array of floats, using info from the GRIB2 Data Representation Template 5.40 or 5.40000. int g2c_log_file (int g2cid)
Print a summary of the contents of an open GRIB2 file. int g2c_open (const char *path, int mode, int *g2cid)
Open an existing GRIB2 file. int g2c_open_index (const char *data_file, const char *index_file, int mode, int *g2cid)
Open a GRIB2 file with the help of an index file. int g2c_open_index1 (const char *index_file)
Open a GRIB1 index file and read the contents. int g2c_param_abbrev (int g2disc, int g2cat, int g2num, char *abbrev)
Get NOAA abbreviation for a GRIB2 parameter. int g2c_param_all (int param_idx, int *g1ver, int *g1val, int *g2disc, int *g2cat, int *g2num, char *abbdrev)
Return all the information about a parameter. int g2c_param_g1tog2 (int g1val, int g1ver, int *g2disc, int *g2cat, int *g2num)
Translate GRIB1 parameter to GRIB2 parameter. int g2c_param_g2tog1 (int g2disc, int g2cat, int g2num, int *g1val, int *g1ver)
Translate GRIB2 parameter to GRIB1 parameter. int g2c_pngpackd (double *fld, size_t width, size_t height, int *idrstmpl, unsigned char *cpack, int *lcpack)
This subroutine packs up a double data field into PNG image format. int g2c_pngpackf (float *fld, size_t width, size_t height, int *idrstmpl, unsigned char *cpack, int *lcpack)
This subroutine packs up a float data field into PNG image format. int g2c_pngunpackd (unsigned char *cpack, size_t len, int *idrstmpl, size_t ndpts, double *fld)
This subroutine unpacks a data field that was packed into a PNG image format using info from the GRIB2 Data Representation Template 5.41 or 5.40010. int g2c_pngunpackf (unsigned char *cpack, size_t len, int *idrstmpl, size_t ndpts, float *fld)
This subroutine unpacks a data field that was packed into a PNG image format using info from the GRIB2 Data Representation Template 5.41 or 5.40010. int g2c_seekmsg (int g2cid, size_t skip, size_t *offset, size_t *msglen)
Search a file for the next GRIB2 Message. int g2c_set_log_level (int new_level)
Use this to set the global log level. const char * g2c_strerror (int g2cerr)
Given an error code, return an error message. int g2c_unpack7 (unsigned char *cgrib, int igdsnum, int gds_tmpl_len, long long int *gdstmpl, int idrsnum, int drs_tmpl_len, long long int *drstmpl, int ndpts, float *fld)
This subroutine unpacks Section 7 (Data Section) of a GRIB2 message. int g2c_write_index (int g2cid, int mode, const char *index_file)
Create an index file from a GRIB2 file, just like those created by the grb2index utility. void seekgb (FILE *lugb, g2int iseek, g2int mseek, g2int *lskip, g2int *lgrib)
Search a file for the next GRIB Message.

Program History Log¶

Date Programmer Comments 2002-10-25 Gilbert Initial 2009-01-14 Vuong Changed struct template to gtemplate 2021-11-9 Ed Hartnett Moved many prototypes to new internal header grib2_int.h. 2022-04-15 Ed Hartnett Added error codes related to JPEG. 2022-08-15 Ed Hartnett Added compression functions for double. 2023-09-10 Eric Engle Added AEC compression.

Author

Date

Author

Definition in file grib2.h.

#define G2_ADD_MSG_COMPLETE -2¶

GRIB message already complete. Cannot add new section.

Definition at line 459 of file grib2.h.

#define G2_ADD_MSG_INIT -1¶

GRIB message was not initialized - call g2_create() first.

Definition at line 458 of file grib2.h.

#define G2_ADDFIELD_BAD_BITMAP -8¶

In g2_addfield() no bitmap in the GRIB message.

Definition at line 464 of file grib2.h.

#define G2_ADDFIELD_BAD_DRT -7¶

In g2_addfield() unsupported Data Representationi Template.

Definition at line 463 of file grib2.h.

#define G2_ADDFIELD_BAD_GDS -6¶

In g2_addfield() section 3 (GDS) not previously defined in message.

Definition at line 462 of file grib2.h.

#define G2_ADDFIELD_BAD_GDT -9¶

In g2_addfield() GDT of one of 5.50 through 5.53 required when using DRT 5.51.

Definition at line 465 of file grib2.h.

#define G2_ADDFIELD_BAD_PDT -5¶

In g2_addfield() could not find requested Product Definition Template.

Definition at line 461 of file grib2.h.

#define G2_ADDFIELD_ERR -10¶

In g2_addfield() error packing data field.

Definition at line 466 of file grib2.h.

#define G2_ADDGRID_BAD_GDT -5¶

In g2_addgrid() Could not find requested Grid Definition Template.

Definition at line 467 of file grib2.h.

#define G2_AEC_ENABLED 1¶

Decoding/encoding AEC/CCSDS is enabled.

Definition at line 29 of file grib2.h.

#define G2_BAD_SEC -4¶

Previous Section was unexpected.

Definition at line 448 of file grib2.h.

#define G2_BAD_SEC_COUNTS -3¶

Sum of Section byte counts doesn't add to total byte count.

Definition at line 460 of file grib2.h.

#define G2_CREATE_GRIB_VERSION -1¶

Wrong GRIB version for g2_create(), must be 2.

Definition at line 424 of file grib2.h.

#define G2_GETFLD_BAD_END 7¶

g2_getfld() didn't find '7777' at end of message.

Definition at line 436 of file grib2.h.

#define G2_GETFLD_BAD_SEC1 15¶

Error in g2_getfld() unpacking section 1.

Definition at line 439 of file grib2.h.

#define G2_GETFLD_BAD_SEC2 16¶

Error in g2_getfld() unpacking section 2.

Definition at line 440 of file grib2.h.

#define G2_GETFLD_BAD_SEC3 10¶

Error in g2_getfld() unpacking section 3.

Definition at line 441 of file grib2.h.

#define G2_GETFLD_BAD_SEC4 11¶

Error in g2_getfld() unpacking section 4.

Definition at line 442 of file grib2.h.

#define G2_GETFLD_BAD_SEC5 12¶

Error in g2_getfld() unpacking section 5.

Definition at line 443 of file grib2.h.

#define G2_GETFLD_BAD_SEC6 13¶

Error in g2_getfld() unpacking section 6.

Definition at line 444 of file grib2.h.

#define G2_GETFLD_BAD_SEC7 14¶

Error in g2_getfld() unpacking section 7.

Definition at line 445 of file grib2.h.

#define G2_GETFLD_GRIB_VERSION 2¶

Wrong GRIB version for g2_getfld(), must be 2.

Definition at line 432 of file grib2.h.

#define G2_GETFLD_INVAL 3¶

g2_getfld() data field request number was not positive.

Definition at line 433 of file grib2.h.

#define G2_GETFLD_INVAL_SEC 8¶

g2_getfld() encountered unrecognized section.

Definition at line 437 of file grib2.h.

#define G2_GETFLD_NO_BITMAP 17¶

In g2_getfld() previous bitmap specified, yet none exists.

Definition at line 446 of file grib2.h.

#define G2_GETFLD_NO_DRT 9¶

In g2_getfld(), Data Representation Template not implemented.

Definition at line 438 of file grib2.h.

#define G2_GETFLD_NO_GRIB 1¶

g2_getfld() can't find beginning characters 'GRIB'.

Definition at line 431 of file grib2.h.

#define G2_GETFLD_WRONG_END 4¶

g2_info() found '7777' not where expected.

Definition at line 434 of file grib2.h.

#define G2_GETFLD_WRONG_NFLDS 6¶

In g2_getfld() message did not contain the requested number of data fields.

Definition at line 435 of file grib2.h.

#define G2_GRIBEND_MSG_INIT -1¶

In g2_gribend() GRIB message was not initialized - call g2_create() first.

Definition at line 447 of file grib2.h.

#define G2_INFO_BAD_END 5¶

g2_info() didn't find '7777' at end of message.

Definition at line 429 of file grib2.h.

#define G2_INFO_GRIB_VERSION 2¶

Wrong GRIB version for g2_info(), must be 2.

Definition at line 426 of file grib2.h.

#define G2_INFO_INVAL_SEC 6¶

g2_info() found invalid section number.

Definition at line 430 of file grib2.h.

#define G2_INFO_NO_GRIB 1¶

g2_info() can't find beginning characters 'GRIB'.

Definition at line 425 of file grib2.h.

#define G2_INFO_NO_SEC1 3¶

g2_info() can't find section 1.

Definition at line 427 of file grib2.h.

#define G2_INFO_WRONG_END 4¶

g2_info() found '7777' not where expected.

Definition at line 428 of file grib2.h.

#define G2_JASPER_DECODE -3¶

In dec_jpeg2000() error decoding image with jasper.

Definition at line 472 of file grib2.h.

#define G2_JASPER_DECODE_COLOR -5¶

In dec_jpeg2000() decoded image had multiple color components.

Definition at line 473 of file grib2.h.

#define G2_JASPER_ENCODE -3¶

In enc_jpeg2000() error encoding image with jasper.

Definition at line 471 of file grib2.h.

#define G2_JASPER_INIT -2¶

In enc_jpeg2000()/dec_jpeg2000() error initializing jasper library.

Definition at line 470 of file grib2.h.

#define G2_JPCUNPACK_MEM 1¶

In jpcunpack() or other unpack function: out of memory.

Definition at line 468 of file grib2.h.

#define G2_JPEG2000_ENABLED 1¶

Decoding/encoding JPEG2000 is enabled.

Definition at line 28 of file grib2.h.

#define G2_NO_ERROR 0¶

Function succeeded.

Definition at line 423 of file grib2.h.

#define G2_PNG_ENABLED 1¶

Decoding/encoding PNG is enabled.

Definition at line 27 of file grib2.h.

#define G2_SPECUNPACK_TYPE -3¶

In specunpack() Can't handle 64 or 128 bit floats.

Definition at line 469 of file grib2.h.

#define G2_UNPACK3_BAD_GDT 5¶

In g2_unpack3(), undefined Grid Definition Template.

Definition at line 451 of file grib2.h.

#define G2_UNPACK4_BAD_PDT 5¶

In g2_unpack4(), undefined Product Definition Template.

Definition at line 452 of file grib2.h.

#define G2_UNPACK5_BAD_DRT 7¶

In g2_unpack5(), undefined Data Representation Template.

Definition at line 453 of file grib2.h.

#define G2_UNPACK6_BAD_BITMAP 4¶

In g2_unpack6(), unrecognized pre-defined bit-map.

Definition at line 454 of file grib2.h.

#define G2_UNPACK7_BAD_DRT 4¶

In g2_unpack7(), unrecognized Data Representation Template.

Definition at line 457 of file grib2.h.

#define G2_UNPACK7_CORRUPT_SEC 7¶

In g2_unpack7(), corrupt section 7.

Definition at line 455 of file grib2.h.

#define G2_UNPACK7_WRONG_GDT 5¶

In g2_unpack7(), need one of GDT 3.50 through 3.53 to decode DRT 5.51.

Definition at line 456 of file grib2.h.

#define G2_UNPACK_BAD_SEC 2¶

Bad section number in unpacking function.

Definition at line 449 of file grib2.h.

#define G2_UNPACK_NO_MEM 6¶

Error allocating memory in unpack function.

Definition at line 450 of file grib2.h.

#define G2C_AEC_DRS_TEMPLATE_LEN 8¶

Length of the idrstmpl array for AEC packing.

Definition at line 407 of file grib2.h.

#define G2C_BYTE 1¶

signed 1 byte integer

Definition at line 260 of file grib2.h.

#define G2C_CHAR 2¶

ISO/ASCII character.

Definition at line 261 of file grib2.h.

#define G2C_CLOBBER 0x0000¶

Destroy existing file. Mode flag for g2c_create().

Definition at line 277 of file grib2.h.

#define G2C_DOUBLE 6¶

double precision floating point number

Definition at line 265 of file grib2.h.

#define G2C_EAEC (-74)¶

Error encoding/decoding AEC data.

Definition at line 502 of file grib2.h.

#define G2C_EBADEND (-65)¶

End of message in wrong place.

Definition at line 493 of file grib2.h.

#define G2C_EBADID (-55)¶

Bad ID.

Definition at line 483 of file grib2.h.

#define G2C_EBADSECTION (-66)¶

Invalid section number.

Definition at line 494 of file grib2.h.

#define G2C_EBADTEMPLATE (-70)¶

Template problem.

Definition at line 498 of file grib2.h.

#define G2C_EBADTYPE (-73)¶

Type not found.

Definition at line 501 of file grib2.h.

#define G2C_ECSV (-75)¶

CSV error.

Definition at line 503 of file grib2.h.

#define G2C_EFILE (-54)¶

File I/O error.

Definition at line 482 of file grib2.h.

#define G2C_EINVAL (-53)¶

Invalid input.

Definition at line 481 of file grib2.h.

#define G2C_EJPEG (-67)¶

Error encoding/decoding JPEG data.

Definition at line 495 of file grib2.h.

#define G2C_EMSG (-58)¶

Error decoding GRIB message.

Definition at line 486 of file grib2.h.

#define G2C_EMSGCOMPLETE (-51)¶

GRIB message already complete.

Definition at line 479 of file grib2.h.

#define G2C_ENAMETOOLONG (-52)¶

Name too long.

Definition at line 480 of file grib2.h.

#define G2C_ENOEND (-64)¶

Cannot find end of GRIB message.

Definition at line 492 of file grib2.h.

#define G2C_ENOMEM (-57)¶

Out of memory.

Definition at line 485 of file grib2.h.

#define G2C_ENOMSG (-59)¶

No GRIB message found.

Definition at line 487 of file grib2.h.

#define G2C_ENOPARAM (-71)¶

Parameter not found.

Definition at line 499 of file grib2.h.

#define G2C_ENOPRODUCT (-72)¶

Product not found.

Definition at line 500 of file grib2.h.

#define G2C_ENOSECTION (-63)¶

Cannot find section.

Definition at line 491 of file grib2.h.

#define G2C_ENOTEMPLATE (-69)¶

Template not found.

Definition at line 497 of file grib2.h.

#define G2C_ENOTFOUND (-61)¶

Table or entry not found.

Definition at line 489 of file grib2.h.

#define G2C_ENOTGRIB (-50)¶

GRIB header not found.

Definition at line 478 of file grib2.h.

#define G2C_ENOTGRIB2 (-62)¶

Not GRIB 2.

Definition at line 490 of file grib2.h.

#define G2C_EPNG (-68)¶

Error encoding/decoding PNG data.

Definition at line 496 of file grib2.h.

#define G2C_ERROR 1¶

General error code, returned for some test errors.

Definition at line 477 of file grib2.h.

#define G2C_ETOOMANYFILES (-56)¶

Trying to open too many files.

Definition at line 484 of file grib2.h.

#define G2C_EXML (-60)¶

XML error.

Definition at line 488 of file grib2.h.

#define G2C_FLOAT 5¶

single precision floating point number

Definition at line 264 of file grib2.h.

#define G2C_INT 4¶

signed 4 byte integer

Definition at line 263 of file grib2.h.

#define G2C_INT64 10¶

signed 8-byte int

Definition at line 269 of file grib2.h.

#define G2C_JASPER_MAX_MEM¶

Maximum size for the Jasper memory buffer.

Definition at line 420 of file grib2.h.

#define G2C_JPEG_DRS_TEMPLATE_LEN 7¶

Length of the idrstmpl array for JPEG packing.

Definition at line 405 of file grib2.h.

#define G2C_LARGE_FILE_INDEX 0x0008¶

Create a large file index. Mode flag for g2c_write_index().

Definition at line 279 of file grib2.h.

#define G2C_MAX_DRS_TEMPLATE 10¶

Maximum number of DRS templates.

Definition at line 296 of file grib2.h.

#define G2C_MAX_DRS_TEMPLATE_MAPLEN 18¶

Maximum DRS template map length.

Definition at line 297 of file grib2.h.

#define G2C_MAX_FILES 3¶

Maximum number of open files.

Definition at line 273 of file grib2.h.

#define G2C_MAX_GDS_TEMPLATE 31¶

Maximum number of grid templates.

Definition at line 292 of file grib2.h.

#define G2C_MAX_GDS_TEMPLATE_MAPLEN 28¶

Maximum grid template map length.

Definition at line 293 of file grib2.h.

#define G2C_MAX_GRIB_CODE_LEN 20¶

Maximum length of code.

Definition at line 412 of file grib2.h.

#define G2C_MAX_GRIB_DESC_LEN 512¶

Maximum length of code description.

Definition at line 409 of file grib2.h.

#define G2C_MAX_GRIB_LEVEL_DESC_LEN 40¶

Maximum length of level description.

Definition at line 411 of file grib2.h.

#define G2C_MAX_GRIB_STATUS_LEN 40¶

Maximum length of code status.

Definition at line 410 of file grib2.h.

#define G2C_MAX_GRIB_TITLE_LEN 200¶

Maximum length of code table title.

Definition at line 413 of file grib2.h.

#define G2C_MAX_NAME 1024¶

Maximum length of a name.

Definition at line 274 of file grib2.h.

#define G2C_MAX_NOAA_ABBREV_LEN 8¶

Maximum length of a NOAA abbreviation of a parameter.

Definition at line 417 of file grib2.h.

#define G2C_MAX_NOAA_PARAM_LINE_LEN 120¶

Maximum length of a line in the NOAA abbreviation CSV file.

Definition at line 418 of file grib2.h.

#define G2C_MAX_NOAA_PARAMS 2000¶

Maximum number of known parameters with NOAA abbreviations.

Definition at line 416 of file grib2.h.

#define G2C_MAX_NUM_SECTIONS 1024¶

Maximum number of sections that can be handled in one message.

Definition at line 414 of file grib2.h.

#define G2C_MAX_PDS_TEMPLATE 47¶

Maximum number of PDS templates.

Definition at line 294 of file grib2.h.

#define G2C_MAX_PDS_TEMPLATE_MAPLEN 45¶

Maximum template map length.

Definition at line 295 of file grib2.h.

#define G2C_NOCLOBBER 0x0004¶

Don't destroy existing file. Mode flag for g2c_create().

Definition at line 278 of file grib2.h.

#define G2C_NOERROR 0¶

No error.

Definition at line 476 of file grib2.h.

#define G2C_NOWRITE 0x0000¶

Set read-only access for g2c_open().

Definition at line 275 of file grib2.h.

#define G2C_PNG_DRS_TEMPLATE_LEN 5¶

Length of the idrstmpl array for PNG packing.

Definition at line 406 of file grib2.h.

#define G2C_SECTION0_ARRAY_LEN 3¶

Length of section 0 array.

Definition at line 402 of file grib2.h.

#define G2C_SECTION0_BYTES 16¶

Number of bytes in section 0.

Definition at line 282 of file grib2.h.

#define G2C_SECTION0_LEN 3¶

Length of section 0 array.

Definition at line 288 of file grib2.h.

#define G2C_SECTION1_ARRAY_LEN 13¶

Length of section 1 array.

Definition at line 403 of file grib2.h.

#define G2C_SECTION1_BYTES 21¶

Number of bytes in section 1 (not including reserved, optional data at the end of the section).

Definition at line 286 of file grib2.h.

#define G2C_SECTION1_LEN 13¶

Length of section 1 array.

Definition at line 289 of file grib2.h.

#define G2C_SHORT 3¶

signed 2 byte integer

Definition at line 262 of file grib2.h.

#define G2C_UBYTE 7¶

unsigned 1 byte int

Definition at line 266 of file grib2.h.

#define G2C_UINT 9¶

unsigned 4-byte int

Definition at line 268 of file grib2.h.

#define G2C_UINT64 11¶

unsigned 8-byte int

Definition at line 270 of file grib2.h.

#define G2C_USHORT 8¶

unsigned 2-byte int

Definition at line 267 of file grib2.h.

#define G2C_VERSION '2.0.0'¶

Current version of NCEPLIBS-g2c library.

Definition at line 25 of file grib2.h.

#define G2C_WRITE 0x0001¶

Set read-write access for g2c_open().

Definition at line 276 of file grib2.h.

typedef float g2float¶

Float type. This typedef is provided for backward compatibility and is not used by the library any more. Use float in new code.

Definition at line 40 of file grib2.h.

typedef int64_t g2int¶

Long integer type.

Definition at line 32 of file grib2.h.

typedef uint64_t g2intu¶

Unsigned long integer type. This typedef is provided for backward compatibility and is not used by the library any more.

Definition at line 36 of file grib2.h.

typedef struct gribfield gribfield¶

Struct for GRIB field.

Definition at line 221 of file grib2.h.

g2int g2_addfield (unsigned char * cgrib, g2int ipdsnum, g2int * ipdstmpl, float * coordlist, g2int numcoord, g2int idrsnum, g2int * idrstmpl, float * fld, g2int ngrdpts, g2int ibmap, g2int * bmap)¶

Pack sections 4 through 7 and adds them to a GRIB2 message. They are:

4.

Product Definition Section

5.

Data Representation Section

6.

Bit-Map Section

7.

Data Section

This routine is used with routines g2_create(), g2_addlocal(), g2_addgrid(), and g2_gribend() to create a complete GRIB2 message. Function g2_create() must be called first to initialize a new GRIB2 message. Function g2_addgrid() must be called after g2_create() and before this routine to add the appropriate grid description to the GRIB2 message. A call to g2_gribend() is required to complete GRIB2 message after all fields have been added.

Program History Log¶

Date Programmer Comments 2002-11-05 Gilbert Initial 2002-12-23 Gilbert Added complex spherical harmonic packing 2003-08-27 Gilbert Added support for new templates using PNG and JPEG2000 algorithms/templates. 2004-11-29 Gilbert JPEG2000 now can use WMO Template 5.40 PNG can use WMO Template 5.41. Added packing algorithm check. 2005-05-10 Gilbert Imposed minimum size on cpack. 2009-01-14 Vuong Changed structure name template to gtemplate 2023-09-08 Engle Added support for new template, 5.42, using CCSDS compression (libaec).

Parameters

Returns

Note

Author

Date

Definition at line 100 of file g2_addfield.c.

References aecpack(), cmplxpack(), gtemplate::ext, gtemplate::extlen, extpdstemplate(), G2_ADD_MSG_COMPLETE, G2_ADD_MSG_INIT, G2_ADDFIELD_BAD_BITMAP, G2_ADDFIELD_BAD_DRT, G2_ADDFIELD_BAD_GDS, G2_ADDFIELD_BAD_GDT, G2_ADDFIELD_BAD_PDT, G2_ADDFIELD_ERR, G2_BAD_SEC, G2_BAD_SEC_COUNTS, g2c_check_msg(), G2C_EMSGCOMPLETE, G2C_ENOTGRIB, gbit(), getdim(), getdrstemplate(), getpdstemplate(), getpoly(), jpcpack(), gtemplate::map, gtemplate::maplen, mkieee(), gtemplate::needext, pngpack(), sbit(), sbits(), simpack(), and specpack().

g2int g2_addgrid (unsigned char * cgrib, g2int * igds, g2int * igdstmpl, g2int * ideflist, g2int idefnum)¶

Packs a Grid Definition Section (Section 3) and adds it to a GRIB2 message. This function is used with routines g2_create(), g2_addlocal(), g2_addfield(), and g2_gribend() to create a complete GRIB2 message. g2_create() must be called first to initialize a new GRIB2 message.

Parameters

Returns

Note

Author

Date

Definition at line 66 of file g2_addgrid.c.

References gtemplate::ext, extgridtemplate(), gtemplate::extlen, G2_ADD_MSG_COMPLETE, G2_ADD_MSG_INIT, G2_ADDGRID_BAD_GDT, G2_BAD_SEC, G2_BAD_SEC_COUNTS, g2c_check_msg(), G2C_EMSGCOMPLETE, G2C_ENOTGRIB, gbit(), getgridtemplate(), gtemplate::map, gtemplate::maplen, gtemplate::needext, sbit(), and sbits().

g2int g2_addlocal (unsigned char * cgrib, unsigned char * csec2, g2int lcsec2)¶

Adds a Local Use Section (Section 2) to a GRIB2 message. This function is used with routines g2_create(), g2_addgrid(), g2_addfield(), and g2_gribend() to create a complete GRIB2 message.

Parameters

Returns

• G2_ADD_MSG_INIT GRIB message was not initialized. Need to call routine gribcreate first.
• G2_ADD_MSG_COMPLETE GRIB message already complete. Cannot add new section.
• G2_BAD_SEC_COUNTS Sum of Section byte counts doesn't add to total byte count.
• G2_BAD_SEC Previous Section was not 1 or 7.

Note

Author

Date

Definition at line 41 of file g2_addlocal.c.

References G2_ADD_MSG_COMPLETE, G2_ADD_MSG_INIT, G2_BAD_SEC, G2_BAD_SEC_COUNTS, g2c_check_msg(), G2C_EMSGCOMPLETE, G2C_ENOTGRIB, gbit(), and sbit().

g2int g2_create (unsigned char * cgrib, g2int * listsec0, g2int * listsec1)¶

Initialize a new GRIB2 message and pack GRIB2 Section 0 (Indicator Section) and Section 1 (Identification Section). This routine is used with routines g2_addlocal(), g2_addgrid(), g2_addfield(), and g2_gribend() to create a complete GRIB2 message. g2_create() must be called first to initialize a new GRIB2 message. A call to g2_gribend() is required to complete GRIB2 message after all fields have been added.

Parameters

Returns

This routine is intended for use with routines g2_addlocal(), g2_addgrid(), g2_addfield(), and g2_gribend() to create a complete GRIB2 message.

Author

Date

Definition at line 68 of file g2_create.c.

References G2_CREATE_GRIB_VERSION, LENSEC0, MAPSEC1LEN, and sbit().

void g2_free (gribfield * gfld)¶

Free memory that was allocated for struct gribfield.

Parameters

Note

Author

Date

Definition at line 23 of file g2_free.c.

References gribfield::bmap, gribfield::coord_list, gribfield::fld, gribfield::idrtmpl, gribfield::idsect, gribfield::igdtmpl, gribfield::ipdtmpl, gribfield::list_opt, and gribfield::local.

Referenced by g2_getfld().

g2int g2_getfld (unsigned char * cgrib, g2int ifldnum, g2int unpack, g2int expand, gribfield ** gfld)¶

Return all the metadata, template values, bit-map (if applicable), and the unpacked data for a data field. All of the information returned is stored in a gribfield structure, which is defined in file grib2.h. Users of this routine will need to include grib2.h in their source code that calls this routine.

Since there can be multiple data fields packed into a GRIB2 message, the calling routine indicates which field is being requested with the ifldnum argument.

Program History Log¶

Date Programmer Comments 2002-10-28 Gilbert Initial 2013-08-08 Vuong Free up memory in array igds - free(igds)

Parameters

Returns

Note

Example:¶

#include "grib2.h"
gribfield *gfld;
ret=g2_getfld(cgrib,1,1,1,&gfld);


  ...
g2_free(gfld);

Routine g2_info() can be used to first determine how many data fields exist in a given GRIB message.

Note

Author

Date

Definition at line 93 of file g2_getfld.c.

References gribfield::bmap, gribfield::coord_list, gribfield::discipline, gribfield::expanded, gribfield::fld, g2_free(), G2_GETFLD_BAD_END, G2_GETFLD_BAD_SEC1, G2_GETFLD_BAD_SEC2, G2_GETFLD_BAD_SEC3, G2_GETFLD_BAD_SEC4, G2_GETFLD_BAD_SEC5, G2_GETFLD_BAD_SEC6, G2_GETFLD_BAD_SEC7, G2_GETFLD_GRIB_VERSION, G2_GETFLD_INVAL, G2_GETFLD_INVAL_SEC, G2_GETFLD_NO_BITMAP, G2_GETFLD_NO_GRIB, G2_GETFLD_WRONG_END, G2_GETFLD_WRONG_NFLDS, G2_NO_ERROR, g2_unpack1(), g2_unpack2(), g2_unpack3(), g2_unpack4(), g2_unpack5(), g2_unpack6(), g2_unpack7(), gbit(), gribfield::griddef, gribfield::ibmap, gribfield::idrtlen, gribfield::idrtmpl, gribfield::idrtnum, gribfield::idsect, gribfield::idsectlen, gribfield::ifldnum, gribfield::igdtlen, gribfield::igdtmpl, gribfield::igdtnum, gribfield::interp_opt, gribfield::ipdtlen, gribfield::ipdtmpl, gribfield::ipdtnum, gribfield::list_opt, gribfield::local, gribfield::locallen, gribfield::ndpts, gribfield::ngrdpts, gribfield::num_coord, gribfield::num_opt, gribfield::numoct_opt, gribfield::unpacked, and gribfield::version.

g2int g2_gribend (unsigned char * cgrib)¶

Finalize a GRIB2 message after all grids and fields have been added. This function adds the End Section ('7777') to the end of the GRIB message and calculates the length and stores it in the appropriate place in Section 0. This routine is used with routines g2_create(), g2_addlocal(), g2_addgrid(), and g2_addfield() to create a complete GRIB2 message.

Parameters

Returns

Note

Author

Date

Definition at line 40 of file g2_gribend.c.

References G2_ADD_MSG_COMPLETE, G2_ADD_MSG_INIT, G2_BAD_SEC, G2_BAD_SEC_COUNTS, g2c_check_msg(), G2C_EMSGCOMPLETE, G2C_ENOTGRIB, gbit(), and sbit().

g2int g2_info (unsigned char * cgrib, g2int * listsec0, g2int * listsec1, g2int * numfields, g2int * numlocal)¶

Search through a GRIB2 message and return the number of gridded fields found in the message and the number (and maximum size) of Local Use Sections. Other checks are performed to see if the message is a valid GRIB2 message.

Parameters

Returns

Author

Date

Definition at line 70 of file g2_info.c.

References G2_INFO_BAD_END, G2_INFO_GRIB_VERSION, G2_INFO_INVAL_SEC, G2_INFO_NO_GRIB, G2_INFO_NO_SEC1, G2_INFO_WRONG_END, gbit(), and LOG.

g2int g2_unpack1 (unsigned char * cgrib, g2int * iofst, g2int ** ids, g2int * idslen)¶

Unpacks Section 1 - Identification Section of a GRIB2 message.

Parameters

Returns

Author

Date

Definition at line 55 of file g2_unpack1.c.

References G2_NO_ERROR, G2_UNPACK_BAD_SEC, G2_UNPACK_NO_MEM, and gbit().

Referenced by g2_getfld().

g2int g2_unpack2 (unsigned char * cgrib, g2int * iofst, g2int * lencsec2, unsigned char ** csec2)¶

Unpack Section 2 (Local Use Section) of a GRIB2 message.

Program History Log¶

Date Programmer Comments 2002-10-31 Gilbert Initial 2008-12-23 Wesley Initialize lencsec2 Length of Local Use data 2010-08-05 Vuong If section 2 has zero length, ierr=0

Parameters

Returns

Author

Date

Definition at line 37 of file g2_unpack2.c.

References G2_NO_ERROR, G2_UNPACK_BAD_SEC, G2_UNPACK_NO_MEM, and gbit().

Referenced by g2_getfld().

g2int g2_unpack3 (unsigned char * cgrib, g2int * iofst, g2int ** igds, g2int ** igdstmpl, g2int * mapgridlen, g2int ** ideflist, g2int * idefnum)¶

Unpack Section 3 (Grid Definition Section) of a GRIB2 message.

Program History Log¶

Date Programmer Comments 2002-10-31 Gilbert Initial 2009-01-14 Vuong Changed structure name template to gtemplate

Parameters

Returns

Author

Date

Definition at line 62 of file g2_unpack3.c.

References gtemplate::ext, extgridtemplate(), gtemplate::extlen, G2_NO_ERROR, G2_UNPACK3_BAD_GDT, G2_UNPACK_BAD_SEC, G2_UNPACK_NO_MEM, gbit(), gbits(), getgridtemplate(), gtemplate::map, gtemplate::maplen, and gtemplate::needext.

Referenced by g2_getfld(), getdim(), and getpoly().

g2int g2_unpack4 (unsigned char * cgrib, g2int * iofst, g2int * ipdsnum, g2int ** ipdstmpl, g2int * mappdslen, float ** coordlist, g2int * numcoord)¶

Unpack Section 4 (Product Definition Section) of a GRIB2 message.

Program History Log¶

Date Programmer Comments 2002-10-31 Gilbert Initial 2009-01-14 Vuong Changed structure name template to gtemplate

Parameters

Returns

Author

Date

Definition at line 45 of file g2_unpack4.c.

References gtemplate::ext, gtemplate::extlen, extpdstemplate(), G2_NO_ERROR, G2_UNPACK4_BAD_PDT, G2_UNPACK_BAD_SEC, G2_UNPACK_NO_MEM, gbit(), gbits(), getpdstemplate(), gtemplate::map, gtemplate::maplen, gtemplate::needext, and rdieee().

Referenced by g2_getfld().

g2int g2_unpack5 (unsigned char * cgrib, g2int * iofst, g2int * ndpts, g2int * idrsnum, g2int ** idrstmpl, g2int * mapdrslen)¶

Unpack Section 5 (Data Representation Section) of a GRIB2 message.

Program History Log¶

Date Programmer Comments 2002-10-31 Gilbert Initial 2009-01-14 Vuong Changed structure name template to gtemplate

Parameters

Returns

Author

Date

Definition at line 40 of file g2_unpack5.c.

References gtemplate::ext, extdrstemplate(), gtemplate::extlen, G2_NO_ERROR, G2_UNPACK5_BAD_DRT, G2_UNPACK_BAD_SEC, G2_UNPACK_NO_MEM, gbit(), getdrstemplate(), gtemplate::map, gtemplate::maplen, and gtemplate::needext.

Referenced by g2_getfld().

g2int g2_unpack6 (unsigned char * cgrib, g2int * iofst, g2int ngpts, g2int * ibmap, g2int ** bmap)¶

Unpack Section 6 (Bit-Map Section) of a GRIB2 message.

Parameters

Returns

Author

Date

Definition at line 32 of file g2_unpack6.c.

References G2_NO_ERROR, G2_UNPACK_BAD_SEC, G2_UNPACK_NO_MEM, gbit(), and gbits().

Referenced by g2_getfld().

g2int g2_unpack7 (unsigned char * cgrib, g2int * iofst, g2int igdsnum, g2int * igdstmpl, g2int idrsnum, g2int * idrstmpl, g2int ndpts, float ** fld)¶

This subroutine unpacks Section 7 (Data Section) of a GRIB2 message. This function is maintained for backward compatibility. Users may wish to use the newer g2c_unpack7() function instead.

Parameters

Returns

Author

Date

Definition at line 214 of file g2_unpack7.c.

References g2c_unpack7_int().

Referenced by g2_getfld().

int g2c_aecpackd (double * fld, size_t width, size_t height, int * idrstmpl, unsigned char * cpack, size_t * lcpack)¶

This function packs up a double array into a AEC code stream. After the data are scaled, and the reference value is subtracted out, the data are passed to the AEC encoder.

This function also fills in GRIB2 Data Representation Template 5.42 with the appropriate values.

This function is the V2 API version of aecpack() for floats.

Parameters

Returns

Author

Definition at line 410 of file aecpack.c.

References aecpack_int(), and G2C_AEC_DRS_TEMPLATE_LEN.

int g2c_aecpackf (float * fld, size_t width, size_t height, int * idrstmpl, unsigned char * cpack, size_t * lcpack)¶

This function packs up a float array into a AEC code stream. After the data are scaled, and the reference value is subtracted out, the data are passed to the AEC encoder.

This function also fills in GRIB2 Data Representation Template 5.42 with the appropriate values.

This function is the V2 API version of aecpack() for floats.

Parameters

Returns

Author

Definition at line 346 of file aecpack.c.

References aecpack_int(), and G2C_AEC_DRS_TEMPLATE_LEN.

int g2c_aecunpackd (unsigned char * cpack, size_t len, int * idrstmpl, size_t ndpts, double * fld)¶

Unpack AEC compressed data into an array of doubles, using info from the GRIB2 Data Representation Template 5.42. This function is the V2 API version of aecunpack() for doubles.

Parameters

Returns

Author

Date

Definition at line 232 of file aecunpack.c.

References aecunpack_int(), G2C_AEC_DRS_TEMPLATE_LEN, and LOG.

int g2c_aecunpackf (unsigned char * cpack, size_t len, int * idrstmpl, size_t ndpts, float * fld)¶

Unpack AEC compressed data into an array of floats, using info from the GRIB2 Data Representation Template 5.42.

Parameters

Returns

Author

Date

Definition at line 194 of file aecunpack.c.

References aecunpack_int(), G2C_AEC_DRS_TEMPLATE_LEN, and LOG.

int g2c_close (int g2cid)¶

Close a GRIB2 file, freeing resources.

Parameters

Returns

Author

Date

Definition at line 1356 of file g2cfile.c.

References g2c_file_info::f, free_metadata(), G2C_EBADID, G2C_EFILE, g2c_file, G2C_MAX_FILES, G2C_NOERROR, g2c_file_info::g2cid, LOG, MUTEX_LOCK, MUTEX_UNLOCK, g2c_file_info::num_messages, and g2c_file_info::path.

Referenced by main().

int g2c_compare (int g2cid1, int g2cid2)¶

Compare the metadata of two open GRIB2 files.

Parameters

Returns

Author

Date

Definition at line 28 of file g2ccompare.c.

References g2c_message_info::center, g2c_section5_info::data_def, g2c_message_info::day, g2c_message_info::discipline, G2C_EBADID, G2C_ENOSECTION, G2C_ERROR, g2c_file, G2C_MAX_FILES, G2C_NOERROR, g2c_section3_info::grid_def, g2c_message_info::hour, g2c_section3_info::interp_list, g2c_message_info::local_version, LOG, g2c_message_info::master_version, g2c_message_info::minute, g2c_message_info::month, g2c_file_info::msg, g2c_message_info::next, g2c_section_info::next, g2c_section4_info::num_coord, g2c_section3_info::num_data_points, g2c_section5_info::num_data_points, g2c_message_info::num_fields, g2c_message_info::num_local, g2c_file_info::num_messages, g2c_section3_info::num_opt, g2c_section_info::prev, g2c_section4_info::prod_def, g2c_message_info::sec, g2c_section_info::sec_info, g2c_section_info::sec_num, g2c_message_info::second, g2c_message_info::sig_ref_time, g2c_section3_info::source_grid_def, g2c_message_info::status, g2c_message_info::subcenter, g2c_section_info::template, g2c_section_info::template_len, g2c_message_info::type, and g2c_message_info::year.

Referenced by main().

int g2c_csv_init ()¶

Initialize tables from 'CodeFlag.txt'.

Returns

Author

Date

Definition at line 189 of file g2ccsv.c.

References doc, G2C_ECSV, G2C_ENAMETOOLONG, G2C_ENOMEM, g2c_find_table(), G2C_MAX_GRIB_CODE_LEN, G2C_MAX_GRIB_DESC_LEN, G2C_MAX_GRIB_LEVEL_DESC_LEN, G2C_MAX_GRIB_STATUS_LEN, G2C_MAX_GRIB_TITLE_LEN, G2C_NOERROR, and g2c_table.

Referenced by g2c_log_file(), and g2c_log_section1().

int g2c_dec_jpeg2000 (char * injpc, size_t bufsize, int * outfld)¶

Decode a JPEG2000 code stream specified in the JPEG2000 Part-1 standard (i.e., ISO/IEC 15444-1) using JasPer Software.

Parameters

Returns

Author

Date

Definition at line 349 of file decenc_jpeg2000.c.

References int_dec_jpeg2000().

int g2c_degrib2 (int g2cid, const char * fileout)¶

Write a summary file like the degrib2 utility.

Parameters

Returns

Author

Date

Definition at line 634 of file g2cdegrib2.c.

References g2c_message_info::bytes_in_msg, g2c_message_info::bytes_to_msg, g2c_message_info::center, g2c_section5_info::data_def, g2c_message_info::day, g2c_message_info::discipline, G2C_EBADID, G2C_EFILE, G2C_EINVAL, G2C_ENOSECTION, G2C_ERROR, g2c_file, g2c_get_datetime(), g2c_get_level_desc(), g2c_get_prod(), G2C_MAX_FILES, G2C_MAX_NOAA_ABBREV_LEN, G2C_MAX_TYPE_OF_FIXED_SURFACE_LEN, G2C_NOERROR, g2c_param_abbrev(), g2c_section3_info::grid_def, g2c_message_info::hour, g2c_section6_info::indicator, g2c_section3_info::interp_list, g2c_message_info::local_version, LOG, g2c_message_info::master_version, g2c_message_info::minute, g2c_message_info::month, g2c_section_info::msg, g2c_message_info::msg_num, g2c_message_info::next, g2c_section_info::next, g2c_section4_info::num_coord, g2c_section3_info::num_data_points, g2c_section5_info::num_data_points, g2c_message_info::num_fields, g2c_message_info::num_local, g2c_section3_info::num_opt, g2c_section3_info::optional, g2c_section_info::prev, g2c_section4_info::prod_def, g2c_message_info::sec, g2c_section_info::sec_info, g2c_section_info::sec_len, g2c_section_info::sec_num, g2c_message_info::second, g2c_message_info::sig_ref_time, g2c_section3_info::source_grid_def, g2c_message_info::status, g2c_message_info::subcenter, g2c_section_info::template, g2c_section_info::template_len, g2c_message_info::type, and g2c_message_info::year.

Referenced by main().

int g2c_enc_jpeg2000 (unsigned char * cin, int width, int height, int nbits, int ltype, int ratio, int retry, char * outjpc, size_t jpclen)¶

Encode a grayscale image into a JPEG2000 code stream specified in the JPEG2000 Part-1 standard (i.e., ISO/IEC 15444-1) using JasPer Software.

Parameters

Returns

Note

Author

Date

Author

Definition at line 45 of file decenc_jpeg2000.c.

References enc_jpeg2000().

int g2c_find_desc (char * title, int code, char * desc)¶

Given a table title and an integer code, find a description.

Parameters

Author

Date

Returns

Definition at line 131 of file g2ccsv.c.

References g2c_find_desc_str(), and G2C_MAX_GRIB_CODE_LEN.

Referenced by g2c_log_section1().

int g2c_find_desc_str (char * title, char * code, char * desc)¶

Given a table title and a code, find a description.

Parameters

Author

Date

Returns

Definition at line 84 of file g2ccsv.c.

References G2C_EINVAL, G2C_ENOTFOUND, G2C_MAX_GRIB_CODE_LEN, G2C_MAX_GRIB_TITLE_LEN, G2C_NOERROR, and g2c_table.

Referenced by g2c_find_desc().

int g2c_find_msg2 (int g2cid, size_t skip_bytes, size_t max_bytes, size_t * bytes_to_msg, size_t * bytes_in_msg)¶

Search a file for the next GRIB1 or GRIB2 message. A grib message is identified by its indicator section, i.e. an 8-byte sequence with 'GRIB' in bytes 1-4 and a '1' or '2' in byte 8. If found, the length of the message is decoded from bytes 5-7. The search is done over a given section of the file. The search is terminated if an eof or i/o error is encountered.

Parameters

Returns

Author

Date

Definition at line 164 of file g2cfile.c.

References G2C_EBADID, G2C_EFILE, G2C_EINVAL, G2C_EMSG, G2C_ENOMEM, G2C_ERROR, g2c_file, G2C_MAGIC_HEADER_LEN, G2C_NOERROR, LOG, MIN, and READ_BUF_SIZE.

void g2c_free_tables ()¶

Free table memory.

Author

Date

Definition at line 42 of file g2ccsv.c.

References g2c_table.

Referenced by g2c_log_file().

void g2c_gbit_int (unsigned char * in, int * iout, int iskip, int nbits)¶

Extract arbitrary size values from a packed bit string, right justifying each value in the unpacked iout array. This is similar to gbit(), but with int types instead of g2int.

Parameters

Author

Definition at line 113 of file gbits.c.

References g2c_gbits_int().

int g2c_gbits_int (unsigned char * in, int * iout, int iskip, int nbits, int nskip, int n)¶

Extract arbitrary size values from a packed bit string, right justifying each value in the unpacked iout array. This is similar to gbits(), but with int types instead of g2int.

Parameters

Returns

Author

Date

Definition at line 137 of file gbits.c.

References G2C_EINVAL, G2C_ENOMEM, G2C_NOERROR, and gbits().

Referenced by g2c_gbit_int().

int g2c_get_drs_template (int drs_template_num, int * maplen, int * map, int * needext)¶

Get DRS template information. The DRS template consists of a template map, and its length. There are no supported DRS templates with extensions.

Parameters

Returns

Author

Date

Definition at line 261 of file drstemplates.c.

References G2C_ENOTEMPLATE, G2C_MAX_DRS_TEMPLATE, G2C_NOERROR, and templatesdrs.

Referenced by g2c_rw_section5_metadata().

int g2c_get_grid_template (int grid_template_num, int * maplen, int * map, int * needext)¶

Get grid template information. The grid template consists of a template map, its length, and, for some templates, an extra extension map, and its length. If an extension is needed, use g2c_get_grid_template_extension() to get it.

Parameters

Returns

Author

Date

Definition at line 375 of file gridtemplates.c.

References G2C_ENOTEMPLATE, G2C_MAX_GDS_TEMPLATE, G2C_NOERROR, and templatesgrid.

Referenced by g2c_rw_section3_metadata().

int g2c_get_grid_template_extension (int grid_template_num, int * template, int * extlen, int * ext)¶

Get grid template extension information.

Parameters

Returns

Author

Date

Definition at line 300 of file gridtemplates.c.

References gtemplate::ext, extgridtemplate(), gtemplate::extlen, G2C_EINVAL, G2C_ENOMEM, G2C_ENOTEMPLATE, G2C_MAX_GDS_TEMPLATE, G2C_NOERROR, and templatesgrid.

int g2c_get_msg (int g2cid, size_t skip_bytes, size_t max_bytes, size_t * bytes_to_msg, size_t * bytes_in_msg, unsigned char ** cbuf)¶

Search a file for the next GRIB1 or GRIB2 message, and read it, allocating space in memory to hold the message. A grib message is identified by its indicator section, i.e. an 8-byte sequence with 'GRIB' in bytes 1-4 and a '1' or '2' in byte 8. If found, the length of the message is decoded from bytes 5-7. The search is done over a given section of the file. The search is terminated if an EOF or I/O error is encountered.

Parameters

Returns

Author

Date

Definition at line 291 of file g2cfile.c.

References G2C_EBADID, G2C_EFILE, G2C_EINVAL, G2C_ENOMEM, G2C_ENOMSG, G2C_ERROR, g2c_file, G2C_MIN_MAX_BYTES, G2C_NOERROR, LOG, and seekgb().

int g2c_get_pds_template (int pds_template_num, int * maplen, int * map, int * needext)¶

Get PDS template information. The PDS template consists of a template map, its length, and, for some templates, an extra extension map, and its length. If an extension is needed, use g2c_get_pds_template_extension() to get it.

Parameters

Returns

Author

Date

Definition at line 831 of file pdstemplates.c.

References G2C_ENOTEMPLATE, G2C_MAX_PDS_TEMPLATE, G2C_NOERROR, and templatespds.

Referenced by g2c_rw_section4_metadata().

int g2c_get_pds_template_extension (int pds_template_num, int * template, int * extlen, int * ext)¶

Get pds template extension information.

Parameters

Returns

Author

Date

Definition at line 756 of file pdstemplates.c.

References gtemplate::ext, gtemplate::extlen, extpdstemplate(), G2C_EINVAL, G2C_ENOMEM, G2C_ENOTEMPLATE, G2C_MAX_PDS_TEMPLATE, G2C_NOERROR, and templatespds.

int g2c_get_prod (int g2cid, int msg_num, int prod_num, int * num_data_points, float * data)¶

Read the data for a product.

Parameters

Returns

Author

Date

Definition at line 28 of file g2cprod.c.

References g2c_message_info::bytes_to_msg, g2c_section_info::bytes_to_sec, g2c_section5_info::data_def, g2c_file_info::f, G2C_EBADID, G2C_EFILE, G2C_EINVAL, G2C_ENOMEM, G2C_ENOMSG, G2C_ENOPRODUCT, G2C_ENOSECTION, G2C_ERROR, g2c_file, G2C_MAX_FILES, G2C_NOERROR, g2c_unpack7(), g2c_section3_info::grid_def, g2c_section_info::msg, g2c_message_info::msg_num, g2c_message_info::next, g2c_section_info::next, g2c_section5_info::num_data_points, g2c_section_info::prev, g2c_message_info::sec, g2c_section_info::sec_info, g2c_section_info::sec_len, g2c_section_info::sec_num, g2c_section_info::template, and g2c_section_info::template_len.

Referenced by g2c_degrib2().

int g2c_inq (int g2cid, int * num_msg)¶

Learn about a GRIB2 file.

Parameters

Returns

Author

Date

Definition at line 31 of file g2cinq.c.

References G2C_EBADID, g2c_file, G2C_MAX_FILES, G2C_NOERROR, MUTEX_LOCK, MUTEX_UNLOCK, and g2c_file_info::num_messages.

int g2c_inq_dim (int g2cid, int msg_num, int prod_num, int dim_num, size_t * len, char * name, float * val)¶

Learn about the one of the dimensions of a GRIB2 product.

Parameters

Returns

Author

Date

Definition at line 328 of file g2cinq.c.

References G2C_EBADID, G2C_ENOMSG, G2C_ENOPRODUCT, G2C_ENOSECTION, g2c_file, G2C_MAX_FILES, G2C_MAX_NAME, G2C_NOERROR, g2c_dim_info::len, g2c_message_info::msg_num, MUTEX_LOCK, g2c_dim_info::name, g2c_message_info::next, g2c_section_info::next, g2c_section_info::prev, g2c_message_info::sec, g2c_section_info::sec_info, g2c_section_info::sec_num, and g2c_dim_info::value.

int g2c_inq_msg (int g2cid, int msg_num, unsigned char * discipline, int * num_fields, int * num_local, short * center, short * subcenter, unsigned char * master_version, unsigned char * local_version)¶

Learn about a GRIB2 message.

Parameters

Returns

Author

Date

Definition at line 86 of file g2cinq.c.

References g2c_message_info::center, g2c_message_info::discipline, G2C_EBADID, G2C_ENOMSG, g2c_file, G2C_MAX_FILES, G2C_NOERROR, g2c_message_info::local_version, g2c_message_info::master_version, g2c_message_info::msg_num, g2c_message_info::next, g2c_message_info::num_fields, g2c_message_info::num_local, and g2c_message_info::subcenter.

int g2c_inq_msg_time (int g2cid, int msg_num, unsigned char * sig_ref_time, short * year, unsigned char * month, unsigned char * day, unsigned char * hour, unsigned char * minute, unsigned char * second)¶

Learn about the date/time information in a GRIB2 message.

Parameters

Returns

Author

Date

Definition at line 149 of file g2cinq.c.

References g2c_message_info::day, G2C_EBADID, G2C_ENOMSG, g2c_file, G2C_MAX_FILES, G2C_NOERROR, g2c_message_info::hour, g2c_message_info::minute, g2c_message_info::month, g2c_message_info::msg_num, g2c_message_info::next, g2c_message_info::second, g2c_message_info::sig_ref_time, and g2c_message_info::year.

int g2c_inq_prod (int g2cid, int msg_num, int prod_num, int * pds_template_len, long long int * pds_template, int * gds_template_len, long long int * gds_template, int * drs_template_len, long long int * drs_template)¶

Inquire about a product.

Parameters

Returns

Author

Date

Definition at line 207 of file g2cinq.c.

References G2C_EBADID, G2C_ENOMSG, G2C_ENOPRODUCT, G2C_ENOSECTION, g2c_file, G2C_MAX_FILES, G2C_NOERROR, g2c_message_info::msg_num, MUTEX_LOCK, MUTEX_UNLOCK, g2c_message_info::next, g2c_section_info::next, g2c_section_info::prev, g2c_message_info::sec, g2c_section_info::sec_info, g2c_section_info::sec_num, g2c_section_info::template, and g2c_section_info::template_len.

int g2c_jpcpackd (double * fld, size_t width, size_t height, int * idrstmpl, unsigned char * cpack, size_t * lcpack)¶

This function packs up a double array into a JPEG2000 code stream. After the data are scaled, and the reference value is subtracted out, the data are treated as a grayscale image and passed to a JPEG2000 encoder.

This function also fills in GRIB2 Data Representation Template 5.40 or 5.40000 with the appropriate values.

This function is the V2 API version of jpcpack() for doubles.

Parameters

Returns

Author

Definition at line 386 of file jpcpack.c.

References G2C_JPEG_DRS_TEMPLATE_LEN, and jpcpack_int().

int g2c_jpcpackf (float * fld, size_t width, size_t height, int * idrstmpl, unsigned char * cpack, size_t * lcpack)¶

This function packs up a float array into a JPEG2000 code stream. After the data are scaled, and the reference value is subtracted out, the data are treated as a grayscale image and passed to a JPEG2000 encoder.

This function also fills in GRIB2 Data Representation Template 5.40 or 5.40000 with the appropriate values.

This function is the V2 API version of jpcpack() for floats.

Parameters

Returns

Author

Definition at line 320 of file jpcpack.c.

References G2C_JPEG_DRS_TEMPLATE_LEN, and jpcpack_int().

int g2c_jpcunpackd (unsigned char * cpack, size_t len, int * idrstmpl, size_t ndpts, double * fld)¶

Unpack JPEG2000 compressed data into an array of doubles, using info from the GRIB2 Data Representation Template 5.40 or 5.40000. This function is the V2 API version of jpcunpack() for doubles.

Parameters

Returns

Author

Date

Definition at line 199 of file jpcunpack.c.

References G2C_JPEG_DRS_TEMPLATE_LEN, jpcunpack_int(), and LOG.

int g2c_jpcunpackf (unsigned char * cpack, size_t len, int * idrstmpl, size_t ndpts, float * fld)¶

Unpack JPEG2000 compressed data into an array of floats, using info from the GRIB2 Data Representation Template 5.40 or 5.40000.

Parameters

Returns

Author

Date

Definition at line 159 of file jpcunpack.c.

References G2C_JPEG_DRS_TEMPLATE_LEN, jpcunpack_int(), and LOG.

int g2c_log_file (int g2cid)¶

Print a summary of the contents of an open GRIB2 file. If the NCEPLIBS-g2c library is built without the LOGGING option, this function will do nothing.

Parameters

Returns

Author

Definition at line 189 of file g2cutil.c.

References g2c_message_info::bytes_in_msg, g2c_message_info::bytes_to_msg, g2c_message_info::center, g2c_message_info::day, g2c_csv_init(), G2C_EBADID, g2c_file, g2c_free_tables(), g2c_log_section(), g2c_log_section1(), G2C_NOERROR, g2c_table, g2c_message_info::hour, g2c_message_info::local_version, LOG, g2c_message_info::master_version, g2c_message_info::minute, g2c_message_info::month, g2c_message_info::msg_num, g2c_message_info::next, g2c_section_info::next, g2c_message_info::num_fields, g2c_message_info::num_local, g2c_message_info::sec, g2c_message_info::sec1_len, g2c_message_info::second, g2c_message_info::sig_ref_time, g2c_message_info::status, g2c_message_info::subcenter, g2c_message_info::type, and g2c_message_info::year.

Referenced by read_metadata().

int g2c_open (const char * path, int mode, int * g2cid)¶

Open an existing GRIB2 file.

Parameters

Returns

Author

Date

Definition at line 1190 of file g2cfile.c.

References g2c_add_file(), LOG, MUTEX_LOCK, MUTEX_UNLOCK, and read_metadata().

Referenced by main().

int g2c_open_index (const char * data_file, const char * index_file, int mode, int * g2cid)¶

Open a GRIB2 file with the help of an index file. The index file, generated by the grb2index utility, of the g2c_write_index() function, contains the byte offsets for the sections of each message in the GRIB2 file. When a GRIB2 file is opened with an index file, the library does not have to scan the file to locate all metadata.

Parameters

Returns

Author

Date

Definition at line 902 of file g2cindex.c.

References add_msg(), add_section(), g2c_message_info::bytes_to_bms, g2c_message_info::bytes_to_data, g2c_message_info::bytes_to_local, g2c_message_info::bytes_to_msg, g2c_message_info::discipline, g2c_add_file(), G2C_EBADSECTION, G2C_EFILE, G2C_EINVAL, G2C_ENAMETOOLONG, g2c_file, g2c_file_io_ubyte(), g2c_file_io_uint(), G2C_FILE_READ, G2C_INDEX_BASENAME_LEN, G2C_INDEX_DATE_STR_LEN, G2C_INDEX_HEADER_LEN, G2C_INDEX_STR1_LEN, G2C_INDEX_TIME_STR_LEN, g2c_log_section1(), G2C_MAX_NAME, G2C_NOERROR, g2c_rw_section1_metadata(), g2c_start_index_record(), g2c_start_index_record_lf(), LOG, g2c_message_info::master_version, MUTEX_LOCK, and MUTEX_UNLOCK.

Referenced by main().

int g2c_open_index1 (const char * index_file)¶

Open a GRIB1 index file and read the contents.

Parameters

Returns

Author

Date

Definition at line 800 of file g2cindex.c.

References G2C_EFILE, G2C_EINVAL, G2C_FILE_READ, G2C_INDEX1_BDS_VAL_LEN, G2C_INDEX1_BMS_VAL_LEN, G2C_INDEX1_GDS_VAL_LEN, G2C_INDEX1_PDS_VAL_LEN, G2C_INDEX_BASENAME_LEN, G2C_INDEX_DATE_STR_LEN, G2C_INDEX_HEADER_LEN, G2C_INDEX_TIME_STR_LEN, G2C_NOERROR, g2c_start_index1_record(), LOG, MUTEX_LOCK, MUTEX_UNLOCK, read_hdr_rec1(), and read_hdr_rec2().

int g2c_param_abbrev (int g2disc, int g2cat, int g2num, char * abbrev)¶

Get NOAA abbreviation for a GRIB2 parameter.

Parameters

Returns

Author

Date

Definition at line 1091 of file g2cparams.c.

References G2C_MAX_NOAA_ABBREV_LEN, G2C_MAX_NOAA_PARAMS, G2C_NOERROR, LOG, and param.

Referenced by g2c_degrib2(), and g2c_log_section().

int g2c_param_all (int param_idx, int * g1num, int * g1ver, int * g2disc, int * g2cat, int * g2num, char * abbrev)¶

Return all the information about a parameter.

Parameters

Returns

Author

Date

Definition at line 1185 of file g2cparams.c.

References g2c_param::g1num, g2c_param::g1ver, G2C_EINVAL, G2C_MAX_NOAA_ABBREV_LEN, G2C_MAX_NOAA_PARAMS, G2C_NOERROR, g2c_param::g2cat, g2c_param::g2disc, g2c_param::g2num, and param.

int g2c_param_g1tog2 (int g1num, int g1ver, int * g2disc, int * g2cat, int * g2num)¶

Translate GRIB1 parameter to GRIB2 parameter.

Parameters

Returns

Author

Date

Definition at line 1051 of file g2cparams.c.

References G2C_ENOPARAM, G2C_MAX_NOAA_PARAMS, G2C_NOERROR, g2c_param::g2cat, g2c_param::g2disc, g2c_param::g2num, and param.

int g2c_param_g2tog1 (int g2disc, int g2cat, int g2num, int * g1num, int * g1ver)¶

Translate GRIB2 parameter to GRIB1 parameter.

Parameters

Returns

Author

Date

Definition at line 1136 of file g2cparams.c.

References g2c_param::g1num, g2c_param::g1ver, G2C_ENOPARAM, G2C_MAX_NOAA_PARAMS, G2C_NOERROR, LOG, and param.

int g2c_pngpackd (double * fld, size_t width, size_t height, int * idrstmpl, unsigned char * cpack, int * lcpack)¶

This subroutine packs up a double data field into PNG image format. After the data field is scaled, and the reference value is subtracted out, it is treated as a grayscale image and passed to a PNG encoder. It also fills in GRIB2 Data Representation Template 5.41 or 5.40010 with the appropriate values.

Parameters

Returns

Author

Date

Definition at line 348 of file pngpack.c.

References G2C_PNG_DRS_TEMPLATE_LEN, and pngpack_int().

int g2c_pngpackf (float * fld, size_t width, size_t height, int * idrstmpl, unsigned char * cpack, int * lcpack)¶

This subroutine packs up a float data field into PNG image format. After the data field is scaled, and the reference value is subtracted out, it is treated as a grayscale image and passed to a PNG encoder. It also fills in GRIB2 Data Representation Template 5.41 or 5.40010 with the appropriate values.

Parameters

Returns

Author

Definition at line 294 of file pngpack.c.

References G2C_PNG_DRS_TEMPLATE_LEN, and pngpack_int().

int g2c_pngunpackd (unsigned char * cpack, size_t len, int * idrstmpl, size_t ndpts, double * fld)¶

This subroutine unpacks a data field that was packed into a PNG image format using info from the GRIB2 Data Representation Template 5.41 or 5.40010.

Parameters

Returns

Author

Date

Definition at line 188 of file pngunpack.c.

References G2C_PNG_DRS_TEMPLATE_LEN, and pngunpack_int().

int g2c_pngunpackf (unsigned char * cpack, size_t len, int * idrstmpl, size_t ndpts, float * fld)¶

This subroutine unpacks a data field that was packed into a PNG image format using info from the GRIB2 Data Representation Template 5.41 or 5.40010.

Parameters

Returns

Author

Date

Definition at line 156 of file pngunpack.c.

References G2C_PNG_DRS_TEMPLATE_LEN, and pngunpack_int().

int g2c_seekmsg (int g2cid, size_t skip, size_t * offset, size_t * msglen)¶

Search a file for the next GRIB2 Message. The search is terminated when a GRIB2 message is found, or the end of the file is reached.

Parameters

Returns

Author

Date

Definition at line 56 of file g2cfile.c.

References G2C_EBADID, G2C_EFILE, G2C_ENOMEM, g2c_file, G2C_MAGIC_HEADER, G2C_NOERROR, G2C_SEEKMSG_BUFSIZE, hton64, and LOG.

Referenced by read_metadata().

int g2c_set_log_level (int new_level)¶

Use this to set the global log level. Settings:

• -1 turn off all logging.
• 0 show only errors.
• 1 output useful as verbose to utilities.
• 2 or 3 shows some/all calls to top-level functions.
• 4+ ever greater levels of detail.

If logging is not enabled when building NCEPLIBS-g2c, this function will do nothing.

Parameters

Returns

Author

Definition at line 129 of file util.c.

References G2C_NOERROR, and LOG.

Referenced by main().

const char * g2c_strerror (int g2cerr)¶

Given an error code, return an error message.

Parameters

Returns

Author

Definition at line 29 of file g2cutil.c.

References G2C_EBADEND, G2C_EBADID, G2C_EBADSECTION, G2C_EBADTEMPLATE, G2C_EBADTYPE, G2C_EFILE, G2C_EINVAL, G2C_EJPEG, G2C_EMSG, G2C_EMSGCOMPLETE, G2C_ENAMETOOLONG, G2C_ENOEND, G2C_ENOMEM, G2C_ENOMSG, G2C_ENOPARAM, G2C_ENOPRODUCT, G2C_ENOSECTION, G2C_ENOTEMPLATE, G2C_ENOTFOUND, G2C_ENOTGRIB, G2C_ENOTGRIB2, G2C_EPNG, G2C_ETOOMANYFILES, G2C_EXML, and G2C_NOERROR.

int g2c_unpack7 (unsigned char * cgrib, int igdsnum, int gds_tmpl_len, long long int * gdstmpl, int idrsnum, int drs_tmpl_len, long long int * drstmpl, int ndpts, float * fld)¶

This subroutine unpacks Section 7 (Data Section) of a GRIB2 message. This function is the newer version of g2_unpack7().

Parameters

Returns

Author

Date

Definition at line 259 of file g2_unpack7.c.

References G2C_EINVAL, G2C_ENOMEM, g2c_unpack7_int(), and LOG.

Referenced by g2c_get_prod().

int g2c_write_index (int g2cid, int mode, const char * index_file)¶

Create an index file from a GRIB2 file, just like those created by the grb2index utility. The index file starts with two header records:

1.

81-byte header with 'gb2ix1' in columns 42-47.

2.

81-byte header with number of bytes to skip before index records, total length in bytes of the index records, number of index records, and grib file basename written in format ('ix1form:',3i10,2x,a40).

Each following index record corresponds to a grib message and has the internal format:

• byte 001 - 004 length of index record
• byte 005 - 008 bytes to skip in data file before grib message
• byte 009 - 012 bytes to skip in message before lus (local use) (0, if none).
• byte 013 - 016 bytes to skip in message before gds
• byte 017 - 020 bytes to skip in message before pds
• byte 021 - 024 bytes to skip in message before drs
• byte 025 - 028 bytes to skip in message before bms
• byte 029 - 032 bytes to skip in message before data section
• byte 033 - 040 bytes total in the message
• byte 041 - 041 grib version number (currently 2)
• byte 042 - 042 message discipline
• byte 043 - 044 field number within grib2 message (1-based)
• byte 045 - ii identification section (ids)
• byte ii+1- jj grid definition section (gds)
• byte jj+1- kk product definition section (pds)
• byte kk+1- ll the data representation section (drs)
• byte ll+1-ll+6 first 6 bytes of the bit map section (bms)

Parameters

Returns

Author

Date

Definition at line 431 of file g2cindex.c.

References g2c_message_info::bytes_in_msg, g2c_message_info::bytes_to_local, g2c_message_info::bytes_to_msg, g2c_section_info::bytes_to_sec, g2c_message_info::discipline, g2c_file_info::f, g2c_message_info::file, G2C_EBADID, G2C_EFILE, G2C_EINVAL, g2c_file, g2c_file_io_ubyte(), g2c_file_io_uint(), G2C_FILE_WRITE, g2c_get_prod_sections(), G2C_INDEX_BASENAME_LEN, G2C_INDEX_BITMAP_BYTES, G2C_INDEX_FIXED_LEN, G2C_INDEX_FIXED_LEN_2, G2C_INDEX_HEADER_LEN, G2C_LARGE_FILE_INDEX, G2C_MAX_FILES, G2C_NOCLOBBER, G2C_NOERROR, g2c_rw_section1_metadata(), g2c_rw_section3_metadata(), g2c_rw_section4_metadata(), g2c_rw_section5_metadata(), g2c_start_index_record(), g2c_start_index_record_lf(), LOG, g2c_message_info::master_version, MUTEX_LOCK, MUTEX_UNLOCK, g2c_message_info::next, g2c_message_info::num_fields, ONE_BYTE, g2c_message_info::sec1_len, and g2c_section_info::sec_len.

Referenced by main().

void seekgb (FILE * lugb, g2int iseek, g2int mseek, g2int * lskip, g2int * lgrib)¶

Search a file for the next GRIB Message. The search is done starting at byte offset iseek of the file referenced by lugb for mseek bytes at a time. If found, the starting position and length of the message are returned in lskip and lgrib, respectively. The search is terminated when an EOF or I/O error is encountered.

Program History Log¶

Date Programmer Comments 2002-10-28 GILBERT Modified from Iredell's skgb subroutine 2009-01-16 VUONG Changed lskip to 4 instead of sizof(g2int)

Parameters

Author

Date

Definition at line 46 of file seekgb.c.

References BYTE, gbit(), and LOG.

Referenced by g2c_get_msg().