Versions Compared

Key

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

...

Import data from a single file

  • To import data from a single file on an OPeNDAP server, the correct URL needs to be configured in the serverUrl element. To get the correct URL for a single file:

    ...

    ...

    ...

      1. Paste this URL in the serverUrl element in the import configuration file.

    Import data from a catalog

    ...

    An import file (local or on an OPeNDAP server) can contain multiple variables. For each time series set in the import configuration the import uses the external parameter id from the id map configuration to search for the corresponding variable(s) in the file(s) to import. If a corresponding variable is found, then the data from that variable is imported. Only data for the found variables is downloaded and imported, all other data in the import file(s) is ignored.
    For NetCDF files the external parameter id is by default matched to the names of the variables in the NetCDF file to find the required variable to import. There also is an option to use the standard_name attribute or long_name attribute of a variable in the NetCDF file as external parameter id. To use this option add the variable_identification_method property to the import configuration, just above the time series set(s). For example:

    ...

    To import only data for a given period of time, specify either a relative period or an absolute period in the general section of the import configuration file. See relativeViewPeriod, startDateTime and endDateTime for more information. The import will first search the metadata of each file that needs to be imported from the OPeNDAP server. Then for each file that contains data within the specified period, only the data within the specified period will be imported. The start and end of the period are both inclusive.
    This can be used to import only the relevant data if only data for a given period is needed, which can save a lot of time. However, for this to work the import still needs to search through all the metadata of the file(s) to be imported. So for large catalogs that contain a lot of files, it can still take a lot of time for the import to download all the required metadata from the OPeNDAP server.

    ...

    Code Block
    xml
    xml
    	<startDateTime date="2007-07-01" time="00:00:00"/>
    	<endDateTime date="2008-01-01" time="00:00:00"/>
    

    Import data for a given sub gridsubgrid

    This section only applies to the import of grid data. For data with a regular grid that is imported from a NetCDF file, it is in most cases not required to have a grid definition in the grids.xml configuration file. Because for regular grids the import reads the grid definition from the NetCDF file and stores the grid definition directly in the datastore of Delft-FEWS. If for the imported data there is no grid definition present in the grids.xml configuration file, then data for the entire grid is imported.
    To import data for only part of the original grid, it is required to specify a grid definition in the grids.xml configuration file. The grid definition defines the part of the grid that needs to be imported. In other words the grid definition defines a subgrid of the original grid. In this case only data for the configured subgrid is downloaded and imported, the data for the rest of the original grid is ignored. The following restrictions apply:

    • The subgrid must be fully contained within the original grid.
    • The subgrid must have the same geodatum as the original grid.
    • The cellwidth of the subgrid must be the same as the cellwidth of the original grid within a margin of 10 percent.
    • The cellheight of the subgrid must be the same as the cellheight of the original grid within a margin of 10 percent.
    • All cell centers in the subgrid must coincide with cell centers in the original grid within a certain margin.

    For example to import data for a sub grid from the URL http://test.opendap.org/opendap/hyrax/data/nc/sst.mnmean.nc.gz use e.g. the following grid definition in the grids.xml file.

    Code Block
    xml
    xml
    
    TODO
    
    Note

    Importing data for a sub grid currently only works for regular grids.

    For more information about the configuration of grid definitions in Delft-FEWS see Grids.

    TODO Irregular gridsTODO

    Import data from a password protected server

    ...