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"
int main(int argc,char* argv[])
{
!
!
program bufr_get_keys
use eccodes
implicit none
integer FILE*in=NULL;
::ifile
integer/*messagehandle.Requiredinalltheeccodescallsactingona message.*/
:: iret
integercodes_handle* h=NULL;
long *descriptors=NULL;
:: ibufr
integerdouble*values=NULL;
char*typicalDate= NULL;
:: i, count=0
integer(kind=4)long longVal;
:: blockNumber,stationNumber
real(kind=8)doubledoubleVal;
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){
Thefirstbufrmessageis printf("ERROR: unable to open file %s\n", infile);loaded from file,!ibufristhebufridreturnto1;
beusedinsubsequent}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)
{
!GetandprintsomekeysformtheifBUFR(hheader
==NULL){
write(*,*) 'message: ',count
!Weneedtoinstructprintf("Error: unable ecCodes to createexpandhandleallfor message %d\n",cnt);the descriptors!i.e.unpackthe cnt++;data valuescallcodes_set(ibufr,"unpack",1);
!Getascontinue;character }
call codes_get(ibufr,'typicalDate',typicalDate)
write(*,*)' printf("message: %d\n",cnt);typicalDate:',typicalDate!Getasinteger
/*weneed to instruct ecCodes to expand the descriptors call codes_get(ibufr,'blockNumber',blockNumber);
write(*,*) ' blockNumber:',blockNumber
!Getasinteger
i.e.unpack the data values */call codes_get(ibufr,'stationNumber',stationNumber);write(*,*)' CODES_CHECK(codes_set_long(h,"unpack",1),0);stationNumber:',stationNumber!getasreal
/*readandprint 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)doi=1,size(descriptors)
/*longvalue*/
write(*,*)' CODES_CHECK(codes_get_long(h,"stationNumber",&longVal),0);',i,descriptors(i)enddo
printf(" stationNumber: %ld\n",longVal);! ---- array of real ----------------!Gettheexpanded/* 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!Getascharacter
/* ---- string value -----------------*/ call codes_get(ibufr,'typicalDate',typicalDate)
write(*,*) ' typicalDate:',typicalDate!Freearrays
/*getthedeallocate(values)
sizeandallocate 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
enddo
/*get!theClosevalues*/filecallcodes_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
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:
# get handle for message
bufr = codes_bufr_new_from_file(f)
if bufr is None:
break
print("message: %s" % cnt)/*#getwethe values*/
CODES_CHECK(codes_get_double_array(h,"numericValues",values,&values_len),0);
need to instruct ecCodes to expand all the descriptors
#i.e.unpackprintf("the numericValues:\n");data valuesfor(i = 0; i < values_len; i++)codes_set(bufr, 'unpack', 1)
# ---------------------------------------------{
#getvaluesforkeysholdingasinglevalue
printf(" %.10e\n",values[i]); # ---------------------------------------------}
#Nativetypeinteger
/*freeallocatedarrays */key = 'blockNumber'
free(descriptors);
try:
free(values);
print('%s:%s'% free(typicalDate);
(key, codes_get(bufr, key)))
/*exceptdeleteCodesInternalErrorhandleas*/err:codes_handle_delete(h);
print('Errorwith key="%s": cnt++;
%s' % (key, err.msg))
}
# Native type integer
key = 'stationNumber'
fclose(in);
try:
return 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 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)))
exceptCodesInternalErroraserr:: iretinteger:: 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)))
exceptCodesInternalErroraserr:: values
character(len=9)::typicalDatecallcodes_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#deletehandle! ---- array of real ---------------- codes_release(bufr)
# close the filef.close()
defmain():!try:
getthesizeofthevaluesarrayexample()call codes_get_size(ibufr,"numericValues",numberOfValues)
except CodesInternalError as err:print*,'numberofifexapanded values:', numberOfValues
VERBOSE:!allocatearrayfordatavalues
allocate(values(numberOfValues), stat=irettraceback.print_exc(file=sys.stderr)
!gettheexapandedelse:
datavalues
callcodes_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
title
Python
sys.exit(main())
Tabs Page
title
C
Code Block
language
cpp
title
bufr_get_keys.c
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.
*/
/*
* 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
language
python
title
bufr_get_keys.py
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.
#
# 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);
returnprint "message: %s" % cnt1;
}/*loopoverthe# 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:unabletocreatehandle#forget values for keys holding a single value
message %d\n",cnt);
#----------------------------------------------
cnt++;
#Nativetypeintegercontinue;key='blockNumber'}
if not codes_is_defined(gid,key):
printf("message: %d\n",cnt);
/*weneedtoinstruct ecCodestoexpandtheraise 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+"wasnotdefined")
/*longvalue*/
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 */
ifnotCODES_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/*typegetstring
thesizeand key='typicalDate'allocate memory*/if not CODES_CHECK(codes_isget_definedlength(gidh,key):
"typicalDate", &len), 0);
typicalDateraise 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("getvalues for an array
typicalDate: %s\n", typicalDate);
/*#---- array of long -----------------------------
*/
#Nativetypeinteger
/*getthesizeand 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));
/*getprintthevalues'*/
sizeof%sis:%s'% (key,num)
CODES_CHECK(codes_get_long_array(h, "bufrdcExpandedDescriptors", descriptors, &desc_len),0);
#getvalues
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]);#}
Nativetypefloat
/*----arrayof 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 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;
}