THIS IS A TEST INSTANCE. ALL YOUR CHANGES WILL BE LOST!!!!
The Apache SIS visual application is currently used as a testing tools for checking SIS capability to read, transform and visualize data files. However we try to make it usable by non-developers too. We do not yet distribute a binary for this application; it has to be built on developer machine for now.
...
Build, installation and execution
Prerequisites are Java 14, JavaFX 14 (for build and run) and Maven (for build only). Java and JavaFX must be preinstalled; we do not import JavaFX has a Maven dependency the project does not bundle JavaFX for licensing reason. The development version can be built and executed as below (replace path_to_JavaFX by the path to the directory where JavaFX has been installed. Do not forget to append the lib sub-directory):
mkdir SIS && cd SIS
export PATH_TO_FX=path_to_JavaFX/lib
git clone --branch geoapi-4.0 https://github.com/apache/sis
cd geoapi-4.0
mvn install
java --class-path "sis/target/binaries/*" --module-path "$PATH_TO_FX" --add-modules javafx.graphics,javafx.controls org.apache.sis.gui.DataViewercd application/sis-javafx/
mvn package org.apache.sis.core:sis-build-helper:dist
If you accept the EPSG terms of use, the following option can be added to the mvn command: --activate-profiles non-free
The application will be packaged in target/distribution/apache-sis-2.0-SNAPSHOT.zip. Unzip that ZIP file in any directory.
Execution
Execute the following on the command-line, where <install dir> is the directory where apache-sis-2.0-SNAPSHOT.zip has been unzipped:
- Linux / MacOS:
<install dir>/apache-sis-2.0-SNAPSHOT/bin/sisfx
- Windows:
<install dir>\apache-sis-2.0-SNAPSHOT\bin\sisfx.bat
The first time that the application is launched, it will ask for the directory where JavaFX has been installed. It may be necessary to restart sisfx after providing this information.
An easier way will be provided if the application is bundled in an Apache SIS release, but JavaFX will still need to be preinstalled and the use of EPSG geodetic dataset will still need explicit user agreement, for licensing reasons.
...
Open files
Drag and drop some netCDF 3 files in the explorer (the white space area on the left side of main window). Files and their Multiple files or entire directories can be dragged. Opened files are listed and netCDF variables are shown in below each file as a tree. The "Visual" tab visualizes the selected variable. User can pan the raster, zoom with mouse wheel or rotate with keyboard (Alt + arrows). The geospatial coordinates under mouse cursor are shown in the bottom-right corner. Contextual menu allows to select the Coordinate Reference System (CRS) of those coordinates, which does not need to be the same than the raster CRS. The coordinates use the minimal amount of fraction digits needed for pixel resolution at current zoom level. This number varies with zooms, and may also vary at different raster locations depending on the map projection used. If the coordinates shown in the lower-right corner are not on the same datum than the raster, the uncertainty is shown (3 km in the example below because the coordinates are shown in WGS 84 while the raster uses an unspecified datum).
The Coordinate Reference System (CRS) can be selected among the list of CRS supported by Apache SIS. This list is available only if the EPSG geodetic dataset has been installed, which is not the case by default for licensing reason (a future version may provide a plugin download mechanism for easier installation). The dialog box shows a warning in red if the selected CRS does not have a domain of validity intersecting the raster geographic area.
The "Data" tab shows data value in a tabular format. The number of fraction digits is estimated from data resolution, but the format pattern can be modified. Future version will give control on units of measurement (SIS has a flexible units of measurement framework, but it is not used yet in this application).
Known bug: the horizontal scrolling bar may be initially invisible. To make it appears, resize slightly the windows then scroll down a little bit.
The "Metadata" tab shows metadata value in a tree organized along ISO 19115 model. Peoples familiar with ISO 19115 should feel familiar with this tree. A contextual menu allows to export selected nodes and its children to various formats, including ISO 19115-3 (a XML format) and Geographic Markup Language (GML) if the selected element is a CRS.
...
Files can be closed with the contextual menu (click on a file with the right mouse button). The panel on the right side gives a summary of the selected file or variable; more information can be read in the “Metadata” and “Netcdf” tabs. The summary panel shows the data geographic area as a blue bounding box on a world map. In the example below, the geographic area crosses the anti-meridian (the meridian at ±180° of longitude), which causes the bounding box to be shown with two parts on each side of the map. Many (but not all) classes of the Apache SIS library are capable to handle such situation.
Explore data and metadata
Two kinds of information can be explored: the metadata and the data. The metadata provide information necessary for understanding the data. Metadata answer questions such as “what”, “where”, “when” and “how”. Apache SIS adopts the ISO 19115 — Geographic information — Metadata international standard as a universal structure for describing all data that the application can read, regardless data format. The content of selected file can be viewed by clicking on the “Metadata” tab.
Data can be viewed in two ways: either as an image, or as tabular values. Those two visualization modes are provided by “Visual” and “Data” tabs respectively.
More information: