Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Description

This example shows: how to read values of different type of keys from BUFR messages.

Source code

Tabs Container
directionhorizontal


Tabs Page
titleCFortran 90


Code Block
languagecppnone
titlebufr_get_keys.cf90
linenumbersfalse
/*
 * !
!(C) Copyright 2005-2015 ECMWF.
 *!
! * This software is licensed under the terms of the Apache Licence Version 2.0
 * !which can be obtained at http://www.apache.org/licenses/LICENSE-2.0.
 *!
! * In applying this licence, ECMWF does not waive the privileges and immunities granted to it by
 *! virtue of its status as an intergovernmental organisation nor does it submit to any jurisdiction.
 */!
!
/*
! *FORTRAN C90 Implementation: bufr_get_keys
 *!
 *! Description: how to read values of different type of keys from BUFR messages.
 *
 */

#include "eccodes.h"


int main(int argc,char* argv[])
{
!
!
program bufr_get_keys
use eccodes
implicit none
integer       FILE* in = NULL;

  :: ifile
integer /* message handle. Required in all the eccodes calls acting on a message.*/
:: iret
integer    codes_handle* h=NULL;

       long *descriptors=NULL;
 :: ibufr
integer    double *values = NULL;
    char* typicalDate= NULL; 
:: i, count=0
integer(kind=4)    long longVal;
:: blockNumber,stationNumber
real(kind=8)    double doubleVal;
    size_t values_len=0, desc_len=0, len=0;
    int i, err=0;
    int cnt=0;
    char* infile = ":: t2m
integer(kind=4), dimension(:), allocatable    :: descriptors
real(kind=8), dimension(:), allocatable       :: values
character(len=9)   :: typicalDate

  call codes_open_file(ifile,'../../data/bufr/syno_multi.bufr";

    in=fopen(infile,"r");','r')

    if (!in) {
The first bufr message is    printf("ERROR: unable to open file %s\n", infile);loaded from file,
  ! ibufr is the bufr id returnto 1;
be used in subsequent }calls

    /* loop over the messages in the bufr file */
    while ((h =  call codes_handlebufr_new_from_file(NULLifile,in,PRODUCT_BUFR,&err)) != NULL || err != CODES_SUCCESS)
ibufr,iret)

  do while (iret/=CODES_END_OF_FILE)

    {
! Get and print some keys form the ifBUFR (hheader
 == NULL) {
    write(*,*) 'message: ',count

    ! We need to instruct printf("Error: unable ecCodes to createexpand handleall for message %d\n",cnt);the descriptors
    ! i.e. unpack the     cnt++;data values
    call codes_set(ibufr,"unpack",1);

    ! Get as continue;character
        }

call codes_get(ibufr,'typicalDate',typicalDate)
    write(*,*) '   printf("message: %d\n",cnt);typicalDate:',typicalDate

    ! Get as integer
 /*  we need to instruct ecCodes to expand the descriptors call codes_get(ibufr,'blockNumber',blockNumber);
    write(*,*) '  blockNumber:',blockNumber

    ! Get as integer
   i.e. unpack the data values */call codes_get(ibufr,'stationNumber',stationNumber);
    write(*,*) '   CODES_CHECK(codes_set_long(h,"unpack",1),0);stationNumber:',stationNumber

    ! get as real
 /* read and print some data values */ 

call codes_get(ibufr,'airTemperatureAt2M',t2m);
    write(*,*) '   /* long value */
        CODES_CHECK(codes_get_long(h,"blockNumber",&longVal),0);
        printf("  blockNumber: %ld\n",longVal);airTemperatureAt2M:',t2m

    ! ---- array of integer ----------------

    ! get the expanded descriptors
    call codes_get(ibufr,'bufrdcExpandedDescriptors',descriptors)

    do i=1,size(descriptors)
   /* long value */
  write(*,*) '     CODES_CHECK(codes_get_long(h,"stationNumber",&longVal),0);',i,descriptors(i)
    enddo

    printf("  stationNumber: %ld\n",longVal);! ---- array of real ----------------

    ! Get the expanded /* double value */data values
        CODES_CHECK(call codes_get_double(h,"airTemperatureAt2M",&doubleVal),0);ibufr,'numericValues',values)

    do i=1,size(values)
        printf("  airTemperatureAt2M: %f\n",doubleVal);write(*,*) '  ',i,values(i)
    enddo

    ! Get as character
 /* ---- string value  -----------------*/   call codes_get(ibufr,'typicalDate',typicalDate)
    write(*,*) '  typicalDate:',typicalDate

    ! Free arrays
  /* get thedeallocate(values)
 size and allocate memory*/ deallocate(descriptors)

    ! Release the bufr message
    CODEScall codes_CHECK(codes_get_length(h, "typicalDate", &len), 0);
        typicalDate = (char*)malloc(len*sizeof(char));release(ibufr)

    ! Load the next bufr message
    call codes_bufr_new_from_file(ifile,ibufr,iret)

    count=count+1

  end do

 /* get! theClose values*/file
  call      codes_getclose_string(h, "typicalDate", typicalDate, &len);
        printf("  typicalDate: %s\n", typicalDate);

        /* ---- array of long ----------------*/

        /* get the size and allocate memory*/
        CODES_CHECK(codes_get_size(h,"bufrdcExpandedDescriptors",&desc_len),0);
        descriptors = malloc(desc_len*sizeof(long));

        /* get the values */
        CODES_CHECK(codes_get_long_array(h,"bufrdcExpandedDescriptors",descriptors,&desc_len),0);
        printf("  bufrdcExpandedDescriptors:\n");
        for(i = 0; i < desc_len; i++)
        {
            printf("   %ld\n",descriptors[i]);
        }

        /* ---- array of double ---------------*/

        /* get the size and allocate memory*/
        CODES_CHECK(codes_get_size(h,"numericValues",&values_len),0);
        values = malloc(values_len*sizeof(double));file(ifile)

end program bufr_get_keys



Tabs Page
titlePython


Code Block
languagepython
titlebufr_get_keys.py
linenumbersfalse
# (C) Copyright 2005- ECMWF.
#
# This software is licensed under the terms of the Apache Licence Version 2.0
# which can be obtained at http://www.apache.org/licenses/LICENSE-2.0.
#
# In applying this licence, ECMWF does not waive the privileges and immunities
# granted to it by virtue of its status as an intergovernmental organisation
# nor does it submit to any jurisdiction.

#
# Python implementation: bufr_get_keys
#
# Description: how to read values of different type of keys from BUFR messages.
#
#

import sys
import traceback

from eccodes import *

INPUT = '../../data/bufr/syno_multi.bufr'
VERBOSE = 1  # verbose error reporting


def example():
    # open bufr file
    f = open(INPUT, 'rb')

    cnt = 0

    # loop for the messages in the file
    while 1:
        # get handle for message
        bufr = codes_bufr_new_from_file(f)
        if bufr is None:
            break

        print("message: %s" % cnt)

        /*# getwe the values*/
        CODES_CHECK(codes_get_double_array(h,"numericValues",values,&values_len),0);
need to instruct ecCodes to expand all the descriptors
        # i.e. unpack printf("the  numericValues:\n");data values
        for(i = 0; i < values_len; i++)codes_set(bufr, 'unpack', 1)

        # ---------------------------------------------
        {
# get values for keys holding a single value
    printf("   %.10e\n",values[i]);    # ---------------------------------------------
        }

# Native type integer
     /* free allocated arrays */key = 'blockNumber'

        free(descriptors);
try:
          free(values);
  print('  %s: %s' %  free(typicalDate);

(key, codes_get(bufr, key)))
        /*except deleteCodesInternalError handleas */err:
        codes_handle_delete(h);

    print('Error with key="%s" :  cnt++;
%s' % (key, err.msg))

       }

 # Native type integer
        key = 'stationNumber'
      fclose(in);
  try:
      return 0;
}
Tabs Page
titleFortran 90
Code Block
languagenone
titlebufr_get_keys.f90
linenumbersfalse
!
!Copyright 2005-2015 ECMWF.
!
! This software is licensed under the terms of the Apache Licence Version 2.0
!which can be obtained at http://www.apache.org/licenses/LICENSE-2.0.
!
! In applying this licence, ECMWF does not waive the privileges and immunities granted to it by
! virtue of its status as an intergovernmental organisation nor does it submit to any jurisdiction.
!
!
! FOTRAN 90 Implementation: bufr_get_keys
!
! Description: how to read values of different type of keys from BUFR messages.
!
!
program bufr_get_keys
use eccodes
implicit none
integer      print('  %s: %s' % (key, codes_get(bufr, key)))
        except CodesInternalError as err:
            print('Error with key="%s" : %s' % (key, err.msg))

        # Native type float
        key = 'airTemperatureAt2M'
        try:
            print('  %s:  :: ifile
integer%s' % (key, codes_get(bufr, key)))
        except CodesInternalError as  err:: iret
integer            :: ibufr
integer       print('Error with key="%s" : %s' % (key, err.msg))

     :: i, count=0
integer(kind=4)    :: blockNumber,stationNumber 
real(kind=8) # Native type string
        key :: t2m
integer(kind=4)= 'typicalDate'
     :: numberOfValues, numberOfDesc 
integer(kind=4), dimension(:), allocatabletry:
      :: descriptors
real(kind=8), dimension(:), allocatable      print('  %s: %s' % (key, codes_get(bufr, key)))
        except CodesInternalError as err:: values
character(len=9)
       :: typicalDate 

  call codes_open_file(ifile,'../../data/bufr/syno_multi.bufr','r')

! the first bufr message is loaded from file
! ibufr is the bufr id to be used in subsequent calls
  call codes_bufr_new_from_file(ifile,ibufr,iret)

  do while (iret/=CODES_END_OF_FILE)
    
    ! get and print some keys form the BUFR header 
    write(*,*) 'message: ',count

    ! we need to instruct ecCodes to expand all the descriptors 
    ! i.e. unpack the data values
    call codes_set(ibufr,"unpack",1);
    
    
    ! get as character
    call codes_get(ibufr,'typicalDate',typicalDate)
    write(*,*) '  typicalDate:',typicalDate
   
    ! get as integer
    call codes_get(ibufr,'blockNumber',blockNumber);
    write(*,*) '  blockNumber:',blockNumber
    
    ! get as integer
    call codes_get(ibufr,'stationNumber',stationNumber);
    write(*,*) '  stationNumber:',stationNumber
    
    ! get as real
    call codes_get(ibufr,'airTemperatureAt2M',t2m);
    write(*,*) '  airTemperatureAt2M:',t2m
   
 
    ! ---- array of integer ----------------
     
    ! get the size of the values array
    call codes_get_size(ibufr,"bufrdcExpandedDescriptors",numberOfDesc)
    
    print*, '  number of descriptors:', numberOfDesc
    
    ! allocate array for data values
    allocate(descriptors(numberOfDesc), stat=iret)
 
    ! get the exapanded data values
    call codes_get(ibufr,'bufrdcExpandedDescriptors',descriptors)
 
    do i=1,numberOfDescprint('Error with key="%s" : %s' % (key, err.msg))

        # --------------------------------
        # get values for an array
        # --------------------------------
        # Native type integer
        key = 'bufrdcExpandedDescriptors'

        # get size
        num = codes_get_size(bufr, key)
        print('  size of %s is: %s' % (key, num))

        # get values
        values = codes_get_array(bufr, key)
        for i in range(len(values)):
            print("   %d %06d" % (i + 1, values[i]))

        # Native type float
        key = 'numericValues'

        # get size
        num = codes_get_size(bufr, key)
        print('  size of %s is: %s' % (key, num))

        # get values
        values = codes_get_array(bufr, key)
        for i in range(len(values)):
            print("   %d %.10e" % (i + 1, values[i]))

        write(*,*) '  ',i,descriptors(i)cnt += 1

    enddo  
 
 # delete handle
    ! ---- array of real ----------------    codes_release(bufr)

    # close the file
    f.close()


def main():
    !try:
  get the size of the values arrayexample()
    call codes_get_size(ibufr,"numericValues",numberOfValues)
    except CodesInternalError as err:
    print*, '  number ofif exapanded values:', numberOfValues
    VERBOSE:
    ! allocate array for data values
    allocate(values(numberOfValues), stat=irettraceback.print_exc(file=sys.stderr)
 
    ! get the exapandedelse:
 data values
    call codes_get(ibufr,'numericValues',values)
 
    do i=1,numberOfValues
        write(*,*) '  ',i,values(i)
    enddosys.stderr.write(err.msg + '\n')

   
    ! get as character
    call codes_get(ibufr,'typicalDate',typicalDate)return 1


if __name__ == "__main__":
    write(*,*) '  typicalDate:',typicalDate
   
    ! free arrays 
    deallocate(values)
    deallocate(descriptors)

    ! release the bufr message
    call codes_release(ibufr)

    ! load the next bufr message
    call codes_bufr_new_from_file(ifile,ibufr,iret)
    
    count=count+1
    
  end do  

! close file  
  call codes_close_file(ifile)
 

end program bufr_get_keys
Tabs Page
titlePython
sys.exit(main())



Tabs Page
titleC


Code Block
languagecpp
titlebufr_get_keys.c
linenumbersfalse
/*
 * (C) Copyright 2005- ECMWF.
 *
 * This software is licensed under the terms of the Apache Licence Version 2.0
 * which can be obtained at http://www.apache.org/licenses/LICENSE-2.0.
 *
 * In applying this licence, ECMWF does not waive the privileges and immunities granted to it by
 * virtue of its status as an intergovernmental organisation nor does it submit to any jurisdiction.
 */

/*
 * C Implementation: bufr_get_keys
 *
 * Description: how to read values of different type of keys from BUFR messages.
 *
 */

#include "eccodes.h"

int main(int argc,char* argv[])
{
    FILE* in = NULL;

    /* message handle. Required in all the eccodes calls acting on a message.*/
    codes_handle* h=NULL;

    long *descriptors=NULL;
    double *values = NULL;
    char* typicalDate= NULL;
    long longVal;
    double doubleVal;
    size_t values_len=0, desc_len=0, len=0;
    int i, err=0;
    int cnt=0;
    const char* infile = "../../data/bufr/syno_multi.bufr";

    in=fopen(infile,"rb");
    if (!in) {
Code Block
languagepython
titlebufr_get_keys.py
linenumbersfalse
# Copyright 2005-2015 ECMWF.
#
# This software is licensed under the terms of the Apache Licence Version 2.0
# which can be obtained at http://www.apache.org/licenses/LICENSE-2.0.
#
# In applying this licence, ECMWF does not waive the privileges and immunities granted to it by
# virtue of its status as an intergovernmental organisation nor does it submit to any jurisdiction.

#
# Python implementation: bufr_get_keys
#
# Description: how to read values of different type of keys from BUFR messages.
#
#

import traceback
import sys

from eccodes import *

INPUT='../../data/bufr/syno_multi.bufr'
VERBOSE=1 # verbose error reporting

def example():

    # open bufr file
    f = open(INPUT)

    cnt=0

    # loop for the messages in the file
    while 1:
        # get handle for message
        gid = codes_bufr_new_from_file(f)
        if gid is None: break

printf("ERROR: unable to open file %s\n", infile);
        return print "message: %s" % cnt1;
    }

    /* loop over the # we need to instruct ecCodes to expand all the descriptors
        # i.e. unpack the data valuesmessages in the bufr file */
    while ((h = codes_handle_new_from_file(NULL, in, PRODUCT_BUFR, &err)) != NULL || err != CODES_SUCCESS)
    {
        codes_set(gid,'unpack',1)

if (h == NULL) {
         #----------------------------------------------
   printf("Error: unable to create handle #for get values for keys holding a single value
message %d\n",cnt);
              #----------------------------------------------
cnt++;
          #Native type integercontinue;
        key='blockNumber'}

        if not codes_is_defined(gid,key):
printf("message: %d\n",cnt);

        /* we need to instruct ecCodes to expand the raise Exception("Key: " + key + " was not defined")
        print '  %s: %s' % (key,codes_get(gid,key))

        #Native type integerdescriptors
          i.e. unpack the data values */
        CODES_CHECK(codes_set_long(h, "unpack", 1),0);

        /* read and print some data values */

        key='stationNumber'/* long value */
        if not codes_is_defined(gid,key):CODES_CHECK(codes_get_long(h, "blockNumber", &longVal),0);
        printf("    raise Exception("KeyblockNumber: %ld\n", +longVal);

 key + " was not defined")
  /* long value */
   print '  %s: %s' % (key,codes_get(gid,key))

 CODES_CHECK(codes_get_long(h, "stationNumber", &longVal),0);
        #Native type floatprintf("  stationNumber: %ld\n", longVal);

        key='airTemperatureAt2M'
  /* double value */
      if not CODES_CHECK(codes_isget_defineddouble(gidh,key):
    "airTemperatureAt2M", &doubleVal),0);
         raise Exceptionprintf("Key: " + key + " was not defined")airTemperatureAt2M: %f\n", doubleVal);

        print '  %s: %s' % (key,codes_get(gid,key))/* ---- string value  -----------------*/

        #Native/* typeget string
the size and      key='typicalDate'allocate memory*/
        if not CODES_CHECK(codes_isget_definedlength(gidh,key):
    "typicalDate", &len), 0);
        typicalDate raise Exception("Key: " + key + " was not defined")
    = (char*)malloc(len*sizeof(char));

        /* get the values*/
    print '  %s: %s' % (key,codes_get_string(gidh,key))

        #--------------------------------- "typicalDate", typicalDate, &len);
        #printf(" get values for an array
typicalDate: %s\n", typicalDate);

        /* #---- array of long -----------------------------
    */

    # Native type integer
 /* get the size and   key='bufrdcExpandedDescriptors'

allocate memory*/
        # get sizeCODES_CHECK(codes_get_size(h, "bufrdcExpandedDescriptors", &desc_len),0);
        num=codes_get_size(gid,key)
descriptors = (long*)malloc(desc_len*sizeof(long));

        /* get printthe values '*/
  size of %s is: %s' % (key,num)

    CODES_CHECK(codes_get_long_array(h, "bufrdcExpandedDescriptors", descriptors, &desc_len),0);
     # get values
        values=codes_get_array(gid,key)printf("  bufrdcExpandedDescriptors:\n");
        for(i = 0; i in< xrange(len(values)):desc_len; i++)
        {
       print "   %d %06dprintf(" % (i+1,values  %ld\n",descriptors[i]);

        #}

   Native type float
   /* ---- array of  key='numericValues'double ---------------*/

        #/* get the size and allocate memory*/
        num=CODES_CHECK(codes_get_size(gid,key)
     h, "numericValues", &values_len),0);
   print  '  size of %s is: %s' % (key,num) values = (double*)malloc(values_len*sizeof(double));

        #/* get the values*/
        values=CODES_CHECK(codes_get_double_array(gidh,key)
    "numericValues", values, &values_len),0);
     for i in xrange(len(values)):
   printf("  numericValues:\n");
       print "for(i = 0; %d %.10e" % (i+1,values[i])

i < values_len; i++)
        cnt+=1{

        # delete handle
  printf("      codes_release(gid)

    # close the file
%.10e\n",values[i]);
        f.close()}

def main():
    try:
   /* free allocated   example()
  arrays */
  except CodesInternalError,err:
     free(descriptors);
   if VERBOSE:
    free(values);
        traceback.print_exc(file=sys.stderr)
  free(typicalDate);

      else:
  /* delete handle */
       print >>sys.stderr,err.msg

 codes_handle_delete(h);

         return 1cnt++;
    }

if  __name__ == "__main__": fclose(in);
    sys.exit(main())return 0;
}