ParticleViz is an Open Source software that is used to animate large number of particles inside dynamic web maps. It is designed mostly for Earth Science scientists that simulate different processes using Lagrangian models.
The objectives of this software are:
ParticleViz currently reads NetCDF outputs from OceanParcels and OpenDrift.
git clone https://github.com/olmozavala/particleviz.git
cd particleviz
conda env create -f particleviz.yml
conda activate particleviz
The simplest way to use ParticleViz is to run it specifying the input netcdf from the command line directly (NetCDF should follow OceanParcels or OpenDrift format).
python ParticleViz.py --input_file <path_to_netcdf>
This will generate the default web interface and store the parameters into a configuration file, Current_Config.json
. It can be edited to customize the interface. You need to be patient the first time you run it because it will install all the Javascript dependencies.
Test it with the Global_Marine_Debris.nc example file in the ExampleData folder:
python ParticleViz.py --input_file ExampleData/Global_Marine_Debris.nc
You can run ParticleViz as a docker container. By default it will run using the example netcdf files.
If you want to change it, edit entrypoint.sh
to point to a file inside the particleviz folder.
git clone https://github.com/olmozavala/particleviz.git
cd particleviz
docker build --pull --rm -f Dockerfile -t particleviz "."
docker run --rm -it -p 3000:3000 particleviz:latest
http://localhost:3000/
This is a presentation made at OceanSciences meeting about ParticleViz in March 2022.
Please take a look at the complete docs at https://olmozavala.github.io/particleviz/