DELFT-FEWS
Published Interface
Version 2.6
Guide to the reader
This document describes the interface (data types and formats) that modules need to adhere to when they are to work within the DELFT-FEWS system, together these form the DELFT-FEWS published interface. The document describes the recognised file formats. This includes an extensive description of the formats as defined in XML-Schema files. These are included in the Appendices.
New in version 2.1 (compared to 2.0)
The original General Adapter Specifications document has now been split in two parts. One part describing the General Adapter configuration and one part (this part) describing the files and formats that constitute the published interface. This information is essential to third parties undertaking development of module adapters to interface with NFFS. To avoid confusion the documentation required for configuring the general adapter, itself a part of NFFS, has been moved to the other part. The information in this part should be sufficient for the construction of module adapters for the system. In the new version of the published interface all the separate schema's have been incorporated into a single schema file: fileformats.xsd. Most of the root elements are the same as those in the previous version (see below for a summary of the changes). Apart from the changes to the root elements described below, xml files that conform to the previous implementation can be left unaltered apart from the schema location which is now fileformats.xsd for all types. The following changes have been made since the previous version of the file formats specifications:
...
Grid cell centre points were grouped among the dynamic data types, they are now classified as static data. Conversely, polygons are now listed as dynamic data.
A graphical overviews of the root elements has been added to the description of each format. The complete schema documentation remains in appendix D.
New in version 2.2
Chapter 3 has been updated.
In Chapter 4 the application of module adapters has been added which was also included version 2.0 of this document but has fallen out in version 2.1.
Appendix F is added describing in more detail the interaction between the NFFS and external modules.
New in version 2.3
The updated version 2.3 was made after discussion with HR Wallingford and CEH Wallingford regarding their module adapters.
- The version number of the root elements has been changed to 1.2
- Although the schema does allow otherwise, it has been decided that all datapoints in the timeseries files should be in chronological order.
- A typing error (devider -> divider) has been corrected in the TimStep type
- The single schema (fileformats.xsd) has been split into several files, each containing a single file-format (root element).
New in version 2.4
- Document has been updated to reflect that the PI is a part of DELFT-FEWS and not the NFFS only.
New in version 2.5
- Added memo in appendix F
- Updated explanation in states and diagnostics sections
- Added a questions and answers section
New in version 2.6
- Added netcdf for griddata
...