1. Berkeley Lab
  2. Untitled
  3. WarpIV

Overview

HTTPS SSH

warpiv_warpvisit_logos_sept2015_600px.png

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.

Output generated from the LPA two color example

Install

The below instructions are intended to be issued from the install location.

Warp

First install Forthon, PyMPI and Warp, using these instructions

VisIt

The following instructions are for VisIt on a Linux system. On Apple omit --mesa.

$ svn co svn+ssh://loring@portal-auth.nersc.gov/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.

WarpIV

There's nothing to do, just check it out, runs will be made in-place.

git clone git@bitbucket.org:berkeleylab/warpvisit.git

Running

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

Cigar

./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

Copyright Notice

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.