NCEPLIBS-g2c  1.8.0
aecpack.c File Reference

Pack array of float/double using AEC/CCSDS compression. More...

#include <stdint.h>
#include <stdlib.h>
#include <math.h>
#include <libaec.h>
#include "grib2_int.h"

Go to the source code of this file.

Functions

void aecpack (float *fld, g2int width, g2int height, g2int *idrstmpl, unsigned char *cpack, g2int *lcpack)
 This function packs up a float array into a AEC code stream. More...
 
static int aecpack_int (void *fld, int fld_is_double, g2int width, g2int height, g2int *idrstmpl, unsigned char *cpack, g2int *lcpack, int verbose)
 This internal function packs up a float or double array into a AEC/CCSDS code stream. More...
 
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. More...
 
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. More...
 

Detailed Description

Pack array of float/double using AEC/CCSDS compression.

Author
Eric Engle
Date
2023-09-10

Program History Log

Date Programmer Comments
2023-09-10 Engle Initial; Adapted from aecpack.c.
2023-10-16 Engle Added include libaec to set default values

for CCSDS parameters.

Definition in file aecpack.c.

Function Documentation

◆ aecpack()

void aecpack ( float *  fld,
g2int  width,
g2int  height,
g2int idrstmpl,
unsigned char *  cpack,
g2int 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.

Parameters
fldPointer to the float data values to pack.
widthThe number of points in the x direction.
heightThe number of points in the y direction.
idrstmplContains the array of values for Data Representation Template Table 5.42.
  • 0 Reference value - ignored on input, set by aecpack routine.
  • 1 Binary Scale Factor - used on input, unchanged by aecpack routine.
  • 2 Decimal Scale Factor - used on input, unchanged by aecpack routine.
  • 3 number of bits for each data value - ignored on input
  • 4 Original field type - currently ignored on input Data values assumed to be reals. Set to 0 on output.
  • 5 CCSDS compression options mask.
  • 6 Block size.
  • 7 Reference sample interval. May be modified in this function.
cpackA pointer that will get the packed data field. Must be allocated before this function is called. Pass the allocated size in the lcpack parameter.
lcpackPointer that gets the length of packed field in cpack. This must be set by the calling function to the size available in cpack.
Author
Eric Engle (adapted from jpcpack)

Definition at line 297 of file aecpack.c.

References aecpack_int().

Referenced by g2_addfield().

◆ aecpack_int()

static int aecpack_int ( void *  fld,
int  fld_is_double,
g2int  width,
g2int  height,
g2int idrstmpl,
unsigned char *  cpack,
g2int lcpack,
int  verbose 
)
static

This internal function packs up a float or double array into a AEC/CCSDS code stream.

Parameters
fldPointer to the float or double data values to pack.
fld_is_doubleIf non-zero, then fld points to array of doubles, otherwise an array of floats.
widthThe number of points in the x direction.
heightThe number of points in the y direction.
idrstmplContains the array of values for Data Representation Template Table 5.42. May be modified in this function.
cpackA pointer that will get the packed data field. Must be allocated before this function is called. Pass the allocated size in the lcpack parameter.
lcpackPointer that gets the length of packed field in cpack. This must also be set by the calling function to the size available in cpack.
verboseIf non-zero, error messages will be printed in case of error. Otherwise, error codes will be return but no error messages printed. Calls to the original g2c API may cause error messages to be printed in case of error. For the new g2c_ API, no error messages will be printed - instead an error code will be returned. Call g2c_strerror() to get the error message for any error code.
Returns
Author
Eric Engle

Definition at line 53 of file aecpack.c.

References ALOG2, enc_aec(), G2C_NOERROR, int_power(), LOG, mkieee(), and sbits().

Referenced by aecpack(), g2c_aecpackd(), and g2c_aecpackf().

◆ g2c_aecpackd()

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
fldPointer to the float data values to pack.
widthThe number of points in the x direction.
heightThe number of points in the y direction.
idrstmplContains the array of values for Data Representation Template Table 5.42.
  • 0 Reference value - ignored on input, set by aecpack routine.
  • 1 Binary Scale Factor - used on input, unchanged by aecpack routine.
  • 2 Decimal Scale Factor - used on input, unchanged by aecpack routine.
  • 3 number of bits for each data value - ignored on input
  • 4 Original field type - currently ignored on input Data values assumed to be reals. Set to 0 on output.
  • 5 CCSDS compression options mask.
  • 6 Block size.
  • 7 Reference sample interval. May be modified in this function.
cpackA pointer that will get the packed data field. Must be allocated before this function is called. Pass the allocated size in the lcpack parameter.
lcpackPointer that gets the length of packed field in cpack. This must be set by the calling function to the size available in cpack.
Returns
Author
Eric Engle (adapted from jpcpack)

Definition at line 410 of file aecpack.c.

References aecpack_int(), and G2C_AEC_DRS_TEMPLATE_LEN.

◆ g2c_aecpackf()

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
fldPointer to the float data values to pack.
widthThe number of points in the x direction.
heightThe number of points in the y direction.
idrstmplContains the array of values for Data Representation Template Table 5.42.
  • 0 Reference value - ignored on input, set by aecpack routine.
  • 1 Binary Scale Factor - used on input, unchanged by aecpack routine.
  • 2 Decimal Scale Factor - used on input, unchanged by aecpack routine.
  • 3 number of bits for each data value - ignored on input
  • 4 Original field type - currently ignored on input Data values assumed to be reals. Set to 0 on output.
  • 5 CCSDS compression options mask.
  • 6 Block size.
  • 7 Reference sample interval. May be modified in this function.
cpackA pointer that will get the packed data field. Must be allocated before this function is called. Pass the allocated size in the lcpack parameter.
lcpackPointer that gets the length of packed field in cpack. This must be set by the calling function to the size available in cpack.
Returns
Author
Eric Engle (adapted from jpcpack)

Definition at line 346 of file aecpack.c.

References aecpack_int(), and G2C_AEC_DRS_TEMPLATE_LEN.