Skip to content

Latest commit

 

History

History
58 lines (44 loc) · 1.83 KB

INSTALL.md

File metadata and controls

58 lines (44 loc) · 1.83 KB

Prerequisites

The prerequisites can readily be installed using the conda package manager:

conda create -n ncvis -c conda-forge wxwidgets libnetcdf
conda activate ncvis

Work is presently underway to put ncvis on conda-forge, and is expected for our second release.

Issues with Building under GNU g++ v4.8.5

Issues have been reported with ncvis segfaulting when compiled with GNU g++ version 4.8.5. A compiled executable with GNU g++ version 10 or later does not seem to suffer from this issue. To ensure a modern version of the GNU compiler is used, you may wish to add cxx-compiler to the conda environment.

Install with cmake

A cmake based build infrastructure has been included to assist with configuring the build. To build ncvis in this manner, in the ncvis folder run commands:

cmake .
make all

Install with build.sh

The executable can also be built by running sh ./build.sh. The script has some configurable flags, such as the install prefix. By default the install is created in the root directory.

Install on Cheyenne

On NCAR's Cheyenne supercomputer, by default several modules prevent static linking with HDF5 and other dependencies when building with the netcdf library. To complete the build on Cheyenne the following commands should be run prior to compilation:

module load gnu/12.1.0
module unload ncarenv
module unload ncarcompilers
module unload netcdf

Environment variables

Resources needed by ncvis for execution are normally found in the resources folder, which is assumed to be in the same folder as the ncvis executable. If an alternate resource folder location is needed, the environment variable NCVIS_RESOURCE_DIR should be set to the resources path.