WDC Climate
CERA UI Home | WDCC Home | Impressum

CERA WWW-Gateway - Jblob Version 2 Documentation
Usage jblob
Synopsis

jblob --dataset | -d dataset_acronym [ options ]  
jblob --cmip5file drs_name [ options ]  
jblob --help      
jblob --version      

Options

The following options are supported:

--cdo cdo operator CDO processing during data download. See section "CDO processing" for details.
--config file Read username and password information from file instead of ~/.netrc.
--dateext   Append timestamp(s) to filename instead of record number(s). Works only for datasets with a "calendrical" temporal structure.
--dir directory The transferred dataset will be placed in the specified directory.
--file filename The transferred dataset will be given the specified name instead of datasetname_rmin-rmax.
--origin LTA filename Transfer a single file from a dataset containing DOKU/LTA data.
--password password Use password for database login. Works only in conjunction with --username.
--quiet   Quiet operation. No output except error messages.
--rmax number Last record to transfer. If omitted, the transfer will end with the last available record.
--rmin number First record to transfer. If omitted, the transfer will start with the first available record.
--tmax date Last date to transfer. The standard date format is yyyy-mm-ddThh:mm, however unnecessary parts may be omitted (i.e. yyyy-mm is sufficient when working with monthly data).
--tmin date First date to transfer. The standard date format is yyyy-mm-ddThh:mm, however unnecessary parts may be omitted (i.e. yyyy-mm is sufficient when working with monthly data).
--username username Use username for database login. Works only in conjuction with --password.

Supplying username and password

By default the program tries to read the username and password information from the ~/.netrc file. To utilize this you must add an entry for machine 'cera' to your .netrc file (i.e. machine cera login your_username password your_password). Alternatively you can specify a configuration file from where the login information will be read by using the --config option. This configuration file must follow the same syntax as the .netrc file. As a last resort you can provide username and password with the --username and --password options.
Exit values
0 Success  
1 Unspecified error Please check program output for additional messages (i.e. do not use the -quiet option).
3 Invalid dataset name The requested dataset name is doesn't exist in the database.
4 Invalid dataset id The requested dataset id doesn't exist in the database.
5 Insufficient permission to dataset You do not have the neccessary permission to access the requested dataset. Please contact data@dkrz.de for further assistance.
8 I/O error An I/O error was encountered during the data transfer.
12 Temporal structure not supported for tmin/tmax selection The selected dataset cannot be downloaded by selecting start and end dates, please use selection by record numbers (--rmax, --rmin) instead.
13 Selected start/end record/time outside of datasets coverage. The supplied rmin/rmax/tmin/tmax value(s) are outside of the dataset's coverage.
14 Dataset is empty (data_size = 0) Please contact data@dkrz.de for further information.
CDO processing
The following CDO (1.6.9) operators are currently available for use with Jblob:

sellonlatbox --cdo "sellonlatbox,<min_lon>,<max_lon>,<min_lat>,<max_lat>"
selcode --cdo "selcode,<code>"
selgridname --cdo "selgridname,<grid_name>"

CDO processing is usable with these dataset formats: GRIB, NetCDF, IEG

Please note: processing may take some time, please be patient and DO NOT start the same download again if the first one doesn't start downloading immediately!

Examples
Known Issues