This example shows: how to read values of different type of keys from BUFR messages.
Source code
Tabs Container
direction
horizontal
Tabs Page
title
CFortran 90
Code Block
language
cppnone
title
bufr_get_keys.cf90
linenumbers
false
/*
* !
!(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.
*/!!/*
!*FORTRANC90 Implementation: bufr_get_keys
*! *! Description: how to read values of different type of keys from BUFR messages.
*
*/
#include "eccodes.h"
void usage(char* prog) {
!
!
program bufr_get_keys
use eccodes
implicit none
integer printf("usage:%sinfile\n",prog);
exit(1);
}
int main(int argc,char* argv[])
{
:: ifile
integer FILE*in= NULL;
::iretinteger/*messagehandle.Requiredinalltheeccodes calls acting on a message.*/
:: ibufr
integercodes_handle*h=NULL;
::longi,*descriptorscount=NULL;
0
integer(kind=4)double *values = NULL;
:: blockNumber,stationNumber
real(kind=8) char*typicalDate=NULL;::t2minteger(kind=4),dimension(:),allocatable long::longVal;
double doubleVal;
descriptors
real(kind=8), dimension(:), allocatable size_t:: values_
character(len=0, desc_len=0, len=0;
int i, err=0;
int cnt=0;
char* infile = "9) :: typicalDate
call codes_open_file(ifile,'../../data/bufr/syno_multi.bufr";','r')! in=fopen(infile,"r");
if (!in) {
printf("ERROR: unable to open file %s\n", infile);
return 1;
}
/* loop over the messages in the bufr file */
while ((h = codes_handle_new_from_file(NULL,in,PRODUCT_BUFR,&err)) != NULL || err != CODES_SUCCESS)
{
if (h == NULL) {
printf("Error: unable to create handle for message %d\n",cnt);
cnt++;
continue;
}
printf("message: %d\n",cnt);
/* we need to instruct ecCodes to expand the descriptors
i.e. unpack the data values */
CODES_CHECK(codes_set_long(h,"unpack",1),0);
/* read and print some data values */
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 expanded descriptors
call codes_get(ibufr,'bufrdcExpandedDescriptors',descriptors)
do i=1,size(descriptors)
write(*,*) ' ',i,descriptors(i)
enddo
! ---- array of real ----------------
! Get the expanded data values
call codes_get(ibufr,'numericValues',values)
do i=1,size(values)/* long value */write(*,*) ' ',i,values(i)
enddo
! Get as character
callCODES_CHECK(codes_get_long(h,"blockNumber",&longVal),0);ibufr,'typicalDate',typicalDate)write(*,*)' typicalDate:',typicalDate
printf("!blockNumber: %ld\n",longVal);Free arraysdeallocate(values)deallocate(descriptors)
/* long value */! Release the bufr messagecall CODES_CHECK(codes_get_long(h,"stationNumber",&longVal),0);codes_release(ibufr)
! Load thenextbufrmessage
printf("stationNumber: %ld\n",longVal);call codes_bufr_new_from_file(ifile,ibufr,iret)
count=count+1
enddo
!Close file
/* double value */
CODES_CHECK(codes_get_double(h,"airTemperatureAt2M",&doubleVal),0);
printf(" airTemperatureAt2M: %f\n",doubleVal);
/* ---- string value -----------------*/
/* get the size and allocate memory*/
CODES_CHECK(codes_get_length(h, "typicalDate", &len), 0);
typicalDate = (char*)malloc(len*sizeof(char));
/* get the values*/
grib_get_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));
/* get the values*/
CODES_CHECK(codes_get_double_array(h,"numericValues",values,&values_len),0);
printf(" numericValues:\n");call codes_close_file(ifile)
end program bufr_get_keys
Tabs Page
title
Python
Code Block
language
python
title
bufr_get_keys.py
linenumbers
false
# (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:for(i#=get0;handleifor< values_len; i++)
message
bufr {= codes_bufr_new_from_file(f) printf(" %.10e\n",values[i]);if bufr is None:} break
print("message: %s" % cnt)
/*freeallocated#arrayswe*/
needtoinstructecCodestoexpandallthefree(descriptors);free(values);
free(typicalDate);
# i.e. unpack the data values
codes_set(bufr,'unpack',1)
/*deletehandle*/
#---------------------------------------------
codes_handle_delete(h);
#getvaluesforkeysholdinga single value cnt++;# ---------------------------------------------}
#Nativetypeintegerfclose(in);
keyreturn 0;
}
Tabs Page
title
Fortran 90
Code Block
language
none
title
bufr_get_keys.f90
linenumbers
false
!
!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= 'blockNumber'
try:
print(' %s: %s' % (key, codes_get(bufr, key)))
except CodesInternalError as err:
print('Error with key="%s" : %s' % (key, err.msg))
# Native type integer
key = 'stationNumber'
try:
::ifile
integerprint('%s:%s'% :: iret
integer(key, codes_get(bufr, key)))
exceptCodesInternalError as err:
::ibufr
integerprint('Errorwithkey="%s":%s' :: i, count=0
integer(kind=4)% (key, err.msg))
::blockNumber,stationNumber
real(kind=8)#Nativetypefloat
::t2m
integer(kind=4)::numberOfValues,keynumberOfDesc=
integer(kind=4), dimension(:), allocatable'airTemperatureAt2M'
::descriptors
real(kind=8), dimension(:), allocatable try:
::values
character(len=9)::print('typicalDate%s:%s'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 grib_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 grib_get(ibufr,'bufrdcExpandedDescriptors',descriptors)
do i=1,numberOfDesc
write(*,*) ' ',i,descriptors(i)
enddo
! ---- array of real ----------------
! get the size of the values array
call codes_get_size(ibufr,"numericValues",numberOfValues)
print*, ' number of exapanded values:', numberOfValues
! allocate array for data values
allocate(values(numberOfValues), stat=iret)
! get the exapanded data values
call grib_get(ibufr,'numericValues',values)
do i=1,numberOfValues
write(*,*) ' ',i,values(i)
enddo
! get as character
call grib_get(ibufr,'typicalDate',typicalDate)
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
title
Python
(key, codes_get(bufr, key)))
except CodesInternalError as err:
print('Error with key="%s" : %s' % (key, err.msg))
# Native type string
key = 'typicalDate'
try:
print(' %s: %s' % (key, codes_get(bufr, key)))
except CodesInternalError as err:
print('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]))
cnt += 1
# delete handle
codes_release(bufr)
# close the file
f.close()
def main():
try:
example()
except CodesInternalError as err:
if VERBOSE:
traceback.print_exc(file=sys.stderr)
else:
sys.stderr.write(err.msg + '\n')
return 1
if __name__ == "__main__":
sys.exit(main())
Tabs Page
title
C
Code Block
language
cpp
Code Block
language
python
title
bufr_get_keys.pyc
linenumbers
false
#/*
* (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.
#
# 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
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) {print printf("messageERROR: %s"unable%tocnt
openfile%s\n", infile);
#weneedtoreturninstruct1;
ecCodestoexpand all the descriptors }
/*loopoverthe# i.e. unpack the data valuesmessages in the bufr file */while((h=codes_set(gid,'unpack',1);
#----------------------------------------------handle_new_from_file(NULL, in, PRODUCT_BUFR, &err)) != NULL || err != CODES_SUCCESS){
#getvaluesforkeysholdingasingleifvalue
(h==NULL){
#----------------------------------------------
printf("Error:unabletocreatehandleformessage%d\n",cnt);
#Nativetypeinteger
key='blockNumber'
cnt++;
ifnotcodes_is_defined(gid,key): continue;}
raiseException("Key:"+ key + " was not defined") printf("message: %d\n",cnt);
print/*'weneed%s:to%s'instruct% (key,codes_get(gid,key))
ecCodes to expand the descriptors#Nativetype integer
key='stationNumber' i.e. unpack the data values */if not codes_is_defined(gid,key): CODES_CHECK(codes_set_long(h, "unpack", 1),0);
/*readandprintraise Exception("Key: " + key + " was not defined")
print ' %s: %s' % (key,codes_get(gid,key))some data values */
/* long value */
CODES_CHECK(codes_get_long(h, "blockNumber", &longVal),0);printf("blockNumber:%ld\n",longVal);
#Nativetypefloat
/*long key='airTemperatureAt2M'value */if not CODES_CHECK(codes_isget_defined(gid,key): long(h, "stationNumber", &longVal),0);printf(" raise Exception("KeystationNumber: %ld\n",+longVal);
key+"wasnotdefined")
/*doublevalue*/
print'%s:%s' % (key, CODES_CHECK(codes_get_double(gidh,key))
"airTemperatureAt2M", &doubleVal),0);
printf("#Native type stringairTemperatureAt2M: %f\n", doubleVal);
key='typicalDate'
if not codes_is_defined(gid,key): /* ---- string value -----------------*/
/*getthesizeraise Exception("Key: " + key + " was not defined")
and allocate memory*/
CODES_CHECK(codes_get_length(h, "typicalDate", &len), 0);
print'%s:%s'typicalDate%=(key,codes_get(gid,key))(char*)malloc(len*sizeof(char));
/* get the values*/#---------------------------------
codes_get_string(h, "typicalDate", typicalDate, &len);
#getprintf("valuesfor an arraytypicalDate: %s\n", typicalDate);
#/* ---- array of long -----------------------------*/#/*Nativegettype integer
key='bufrdcExpandedDescriptors'
the size and 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));
print/* getthe'values*/
sizeof%sis:%s'%(key,num)
CODES_CHECK(codes_get_long_array(h, "bufrdcExpandedDescriptors", descriptors, &desc_len),0);
printf("bufrdcExpandedDescriptors:\n");
#getvalues
for(i=0;i<values=codes_get_array(gid,keydesc_len; i++)
for i in xrange(len(values)):{print printf(" %d %06d" % (i+1,values%ld\n",descriptors[i]);}
#Nativetypefloat
/*----array key='numericValues'of double ---------------*/
/*getthesizeand # get sizeallocate memory*/num=CODES_CHECK(codes_get_size(gidh,key)
print ' size of %s is: %s' % (key,num) "numericValues", &values_len),0); 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 inxrange(len(values)):
printf("numericValues:\n");
print"for(i=0;%d %.10e" % (i+1,values[i])
i < values_len; i++)
cnt+=1{#deletehandle
printf(" codes_release(gid)
# close the file
%.10e\n",values[i]);
f.close()}defmain():
try:
/*freeallocated example()
arrays */
exceptCodesInternalError,err:
free(descriptors);
ifVERBOSE:
free(values);
traceback.print_exc(file=sys.stderr)
free(typicalDate);
else:
/*deletehandle*/
print >>sys.stderr,err.msg
codes_handle_delete(h);
return 1cnt++;
}if__name__== "__main__": fclose(in);sys.exit(main())return 0;
}