Versions Compared

Key

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

CodesUI is a graphical user interface for ecCodes to inspect GRIB and BUFR messages.

Note

codesUI is still work-in-progress.

Starting codesUI

The command to start the application on Leap42 and OpenSUSE13.1 workstations at ECMWF is:

can be started up with the following command:

Code Block
Code Block
languagebash
module load codes_ui
codes_ui file1 file2 ...

where the specified files can be either GRIB or BUFR files (wildcard characters are allowed in the file names). If no input files are specified codesUi does CodesUI will not start up.

...

Please note that codesUI can only work in either GRIB or BUFR mode. The actual mode is determined by the type of the first successfully read message from the input files.

The structure of the codesUI interface

The structure of the user interface is similar in both the GRIB and BUFR mode: it is made up of five main panels.

Image Removed

These panels are as follows:

File information panel

This panel is located at the top and displays detailed information about the currently loaded file.

Image Removed

It can be shown/hidden with the

Image Removed

button in the toolbar.

File list panel

This panel is located on the left and contains the list of input files

Image Removed

Click on a given file in the list to load it into codesUi (only one file can be loaded at a time). 

To add a new file to the list use the FileAdd file ...  menu (or press Ctrl+N).

The file list panel can be shown/hidden with the

Image Removed

button in the toolbar. Alternatively it can be closed with the button next to its title.

Message list panel

This panel contains the list of the messages in the currently loaded file and it is located in the middle of the user interface (see here for details on BUFR).

Image Removed

Message content panel

This is the area right of the Message list panel to show the metadata and data of the currently selected message. Its structure and contents is different in GRIB and BUFR mode.

Log panel

This panel at the bottom of the interface shows the log messages.

Image Removed

It can be shown/hidden with the

Image Removed

We can start CodesUI straight in GRIB mode like this:

Code Block
codes_ui -g [grib_file_1 grib_file_2 ...]

or in BUFR mode like this:

Code Block
codes_ui -b [bufr_file_1 bufr_file_2 ...]

In these modes it is not necessary to specify any input files: CodesUI will start up loading the last viewed file of the given typebutton in the toolbar.