You may need to update your browser to view the Water Division pages.

Bureau Home > Water Information > Data Delivery > How to Deliver Data > Naming a Time Series Data File

Naming a Time Series Data File

Data files are named to produce unique file names that inform of their source and contents. The file name is constructed by the concatenation of several elements, in order. File names are considered to be case insensitive.

File name structure

The required file name format is:
FormatName.OrganisationId.DateTime.SiteId-FileType.xml

Element

Mandatory?

Description

FormatName

Yes

Declares the name of the data file format.
This is a data supplier defined name used to describe the data file format. A file format name should apply to only one file format, if the format changes and new name (or variation of the name) should be used. The name should not contain a period '.' character.
Reserved names:

Name	Description
wdtf	Data in the BoM defined water data transfer format - XML.

OrganisationId

Yes

The identifier used to describe a person named under the Water regulations. These identifiers are assigned by the Bureau of Meteorology, it is the login name you use to connect to the FTP server.

DateTime

Yes

The date and time (standard time) that the file was created, in the form YYYYMMDDHHMMSS.

SiteId

Yes

The site identifier used by the data custodian. This identifier should be unique within the organisation. The list of valid identifiers is maintained by the data custodian.

FileType

This element is used to indicate that a file contains continuous time series data (ctsd). If used, the only valid content is 'ctsd'

Example :

Organisation 'w00XXX' - 'Data provider XXX' who creates an export at 8am on 1/July/2008. The data is for monitoring site G8210009. The file format is not one of the Bureau declared formats, the organisation calls it a 'HHRR' format.

Example - File name for continuous time series data

Hhrr-v1.w00010.20080701080000.G8210009-ctsd.txt

Example - File name for all other site data

Hhrr-meta-v1.w00010.20080701080000.G8210009.txt

Skip section menu

Water Information

© Copyright Commonwealth of Australia 2009, Bureau of Meteorology (ABN 92 637 533 532)
Please note the Copyright Notice and Disclaimer statements relating to the use of the information on this site and our site Privacy and Accessibility statements. Users of these web pages are deemed to have read and accepted the conditions described in the Copyright, Disclaimer, and Privacy statements. Please also note the Acknowledgement notice relating to the use of information on this site. No unsolicited commercial email.