Working with NetCDF data

Boundless Server supports data saved in NetCDF format. NetCDF is a community standard for sharing scientific data.

This data can be loaded and published through GeoServer. Both NetCDF 3 and NetCDF 4 formats are supported.

Note

GRIB is also supported via a separate extension.

GeoServer also has the ability to add NetCDF as an output format.

Note

There are different extensions for NetCDF: One to create a data store (reading), one to provide an output format, and one to provide an output format specifically for NetCDF 4.

Installing NetCDF support

NetCDF support isn’t enabled by default, so it must be separately installed through an extension.

Installation instructions are dependent on your operating system and method of install:

Note

The Boundless Server virtual machine has most extensions pre-installed.

Verifying installation

To verify that the data store extension has been installed properly:

  1. Log in to the GeoServer web interface.

  2. Click Stores then Add new store.

  3. In the list of Raster Data Stores, you should see an entry for NetCDF.

    ../../_images/netcdf_storelink.png

    NetCDF in the list of raster stores

    If you don’t see this entry, the extension did not install correctly.

To verify that the output format extension has been installed properly:

  1. Log in to the GeoServer web interface.

  2. Click Global under Settings.

  3. Toward the bottom, you should see a section titled NetCDF Output Settings.

    ../../_images/netcdf-out_config.png

    NetCDF output settings in the list of raster stores

    If you don’t see this entry, the extension did not install correctly.

To verify that the NetCDF native library extension has been installed properly:

  1. Navigate to the GeoServer web application and login using the admin credentials.

  2. Navigate to the GeoServer Detailed Status Page at http://localhost:8080/geoserver/rest/about/status.

  3. Search for “NetCDF Output” on the page and verify that the binary is available.

    ../../_images/ncdf4-status.png

    NetCDF 4 output settings

For more information on adding a store and publishing layers, please see the GeoServer documentation for NetCDF.

Uninstallation

When you install NetCDF-out, your global.xml file is edited. This file is located in the root of your GeoServer data directory.

When uninstalling NetCDF-out, the information in this file needs to be removed manually.

Warning

Failure to manually edit the global.xml file to remove the NetCDF-out content may result in GeoServer failing to load.

  1. Open global.xml in a text editor.

  2. Find the section containing NetCDFOutput.Key and delete it. It will look something like this:

    <metadata>
      <map>
        <entry>
          <string>NetCDFOutput.Key</string>
          <netCDFSettings>
            <compressionLevel>0</compressionLevel>
            <shuffle>true</shuffle>
            <dataPacking>NONE</dataPacking>
          </netCDFSettings>
        </entry>
      </map>
    </metadata>
    
  3. Save and close the file.

  4. Restart the server.