WarpIV: Warp In Situ Visualization Toolkit
WarpIV is a python application that enables efficient, parallel visualization and analysis of simulation data while it is being generated by the Warp simulation framework. WarpIV integrates state-of-the-art in situ visualization and analysis using VisIt with Warp, supports management and control of complex in situ visualization and analysis workflows, and implements integrated analytics to facilitate query and feature-based data analytics and efficient large-scale data analysis.
The below instructions are intended to be issued from the install location.
First install Forthon, PyMPI and Warp, using these instructions
The following instructions are for VisIt on a Linux system. On Apple omit
$ svn co svn+ssh://firstname.lastname@example.org/project/projectdirs/visit/svn/visit/trunk/src visit-src $ mkdir visit-deps $ cd visit-deps ../visit-src/svn_bin/build_visit --netcdf --hdf5 --silo --szip --zlib --system-python --system-qt --mesa --no-visit --parallel --makeflags -j8 --no-pyside --console --arch x86_64 $ cd ../ $ mkdir visit-build $ cd visit-build $ cmake -DCMAKE_INSTALL_PREFIX=`pwd`/../visit-install -DVISIT_CONFIG_SITE=`pwd`/../visit-deps/<some file>.cmake ../visit-src $ make -j8 $ make -j8 install
where <some file> is a file generated by the build visit script, usually named by your hostname.
Clone the repo and build the C++ extensions.
$ git clone email@example.com:berkeleylab/warpiv.git $ cd warpiv $ mkdir bin $ cd bin $ cmake -DCMAKE_BUILD_TYPE=Release .. $ make
The WarpIV.sh is used to launch runs. The user has to at least provide a simulation script, and may optionally provide any number of rendering scripts for non-interactive runs. For more information see the output of WarpIV.sh --help.
Useful command line options for running the examples:
- -np=X, X is the number of MPI ranks, setting to 1 or omiting altogether, results in a serial run w/o MPI.
- --sim-file=X, X is the path and name of the sim file, which is used by VisIt to connect to the simulation in --interact mode
- --interact or --batch will control the mode. Use only one of these. In --batch mode python scripts are used to automatically generate images. In interact mode the simulation will wait for VisIt to connect from the GUI. Start the GUI and open the sim file.
- On systems such as NERSC Edison specify full paths in arguments and use --batch.
LPA Two Color
$ ./WarpIV.sh -np=1 --factory-script=./scripts/lpa/lpa-two-color.py --visit-install=../visit-install/ --sim-file=../lpa.sim2 --script-dir=./scripts/lpa --start=1200 --step=100 --interact
$ ./WarpIV.sh -n=1 --factory-script=./scripts/cigar/cigar.py --visit-install=../visit-install/ --sim-file=../cigar.sim2 --script-dir=./scripts/cigar --start=100 --step=10 --stop=1310 --interact
WarpIV, WarpVisIt Copyright (c) 2015, The Regents of the University of California, through Lawrence Berkeley National Laboratory (subject to receipt of any required approvals from the U.S. Dept. of Energy). All rights reserved.
If you have questions about your rights to use or distribute this software, please contact Berkeley Lab's Innovation & Partnerships Office at IPO@lbl.gov.
NOTICE. This software is owned by the U.S. Department of Energy. As such, the U.S. Government has been granted for itself and others acting on its behalf a paid-up, nonexclusive, irrevocable, worldwide license in the Software to reproduce, prepare derivative works, and perform publicly and display publicly. Beginning five (5) years after the date permission to assert copyright is obtained from the U.S. Department of Energy, and subject to any subsequent five (5) year renewals, the U.S. Government is granted for itself and others acting on its behalf a paid-up, nonexclusive, irrevocable, worldwide license in the Software to reproduce, prepare derivative works, distribute copies to the public, perform publicly and display publicly, and to permit others to do so.