[VISAN Logo]

VISAN Documentation

VISAN is a visualization and analysis tool for atmospheric data. With this application you can ingest product data from atmospheric instruments for missions such as ENVISAT, ERS-2, Aura, MetOp, Sentinel-5P, etc. You can apply a wide range of mathematical operations to this data, and you will be able to create advanced 2D and worldmap plots.

VISAN is the graphical front-end application for the ESA Atmospheric Toolbox. The CODA and HARP libraries are included as part of VISAN and provide the functionality to ingest data from the atmospheric product files. This data can then be further processed using the analysis and visualization components that are built-in into VISAN.

An important aspect of VISAN is that it is an Open Source application. This not only means that you have access to the source code of the application (and are allowed to make changes wherever you want), but also that the implementation of VISAN is for a large part based on various freely available third-party Open Source packages (such as Python, wxPython, VTK, etc.).

A central Open Source package used within VISAN is the powerful high-level programming and scripting language Python. You will interact with VISAN through a Python-driven command line interface. This Python interface provides both easy interactive use and the possibility to implement scripts for advanced and/or repetitive types of analysis. Most of the code of the VISAN application itself was also written using the Python language.

Python provides a flexible way to add useful functionality. There are many freely available extension packages available for Python on the Internet. The VISAN application comes pre-configured with some important packages for your convenience, but you can easily add more. One extension that has already been added is the Numpy package, which provides a set of high-performance mathematical functions such as linear algebra operations, convolutions, Fourier transforms, etcetera.

Below you will find an overview of the documentation that is provided with VISAN.

Release Notes

For the latest release notes concerning this version of VISAN, look at the README file that is included in your VISAN package.

Installing and Running VISAN

For installation instructions for VISAN, look at the INSTALL file that is included in your VISAN package.

VISAN

Tutorial

The Tutorial contains a step-by-step walkthrough that demonstrates some of the VISAN functionality and provides a bird's-eye overview of the application.

User Manual

The User Manual gives a description of the graphical components of VISAN such as the main window and the plot windows. The manual also explains the basic VISAN functionality needed to successfully use the application.

Reference Manual

The Reference Manual provides an overview of all VISAN-specific functions (i.e. functions that are not part of the Python or Numpy packages).

Developer Reference

The Developer Reference is intended for programmers who are interested in extending the functionality of VISAN by implementing their own modules. It also provides instructions on how to add third-party Python extension packages to VISAN.

External documentation

CODA

CODA deals with direct access to product data. The CODA interface for Python is a combination of the low level CODA functions for direct product access (using Cursor objects as used in the C and Fortran interfaces) and the high level CODA functions (using the fetch style functions as used in the MATLAB and IDL interfaces).

A description of the CODA Python interface can be found in the CODA documentation.

HARP

CODA and HARP provide two complementary ways of accessing and dealing with product data. Whereas CODA provides access to the data using the same structure as the data is stored in the product, HARP performs a conversion of the product data to a simplified harmonized datastructure (the HARP data format). The Python interface of HARP included with VISAN allows ingestion of atmospheric data into a Python representation of this HARP data format.

A description of the HARP Python interface can be found in the HARP documentation.

CODA Product Format Definition documentation

For products that do not use a self-describing data format (such as HDF or netCDF) CODA uses Product Format Definitions, stored in .codadef files, to interpret the format of atmospheric data products. A textual version of the Product Format Definitions for the .codadef files that come with VISAN can be found in the Product Format Definition documentation. If you want to know how a data file is structered and where you can find specific data within a file this is the documentation you should consult.

Python

Python is the language in which you provide commands to the VISAN application. It is a very flexible and easy to learn language that can be used to create both small scripts as well as complete applications.

Numpy

Numpy is an extension package for Python that provides a set of high performance mathematical functions such as linear algebra operations, convolutions, Fourier transforms, etcetera. The special Numpy 'array' data structures are used throughout the VISAN application. For instance, all array data that you retrieve via an ingest through CODA or HARP will be stored using these special array types. If you want to perform mathematical operations on these arrays you should thus use the functions from this package.