WASSncplot is a small tool to plot NetCDF 3D data generated with WASS and wassgridsurface on top of the original image files.
WASSncplot requires a Python 3.9 and can simply be installed via pip:
$ python -m pip install wassncplot
To use wassncplot while connected remotely via ssh, launch Xvfb first:
sudo Xvfb :1 -ac -screen 0 1280x720x24
and then set export the DISPLAY environment variable export DISPLAY=:1 before running wassncplot.
WASSncplot is a command-line tool. You can get a description of the available program arguments with the following command:
wassncplot v. 2.2.1
=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
Copyright (C) Filippo Bergamasco 2023
usage: wassncplot [-h] [-f FIRST_INDEX] [-l LAST_INDEX] [-s STEP_INDEX]
[-sd STEP_DATA_INDEX] [-b BASELINE] [--zmin ZMIN]
[--zmax ZMAX] [--alpha ALPHA] [--pxscale PXSCALE]
[--text_prefix TEXT_PREFIX] [--wireframe] [--upscale2x]
[--applymask] [--no-wireframe] [--no-textoverlay]
[--savexyz] [--create-texture] [--save-texture] [--saveimg]
[--ffmpeg] [--ffmpeg-delete-frames]
[--ffmpeg-fps FFMPEG_FPS]
ncfile out
positional arguments:
ncfile Input NetCDF4 file
out Output directory where the produced images will be
stored
optional arguments:
-h, --help show this help message and exit
-f FIRST_INDEX, --first_index FIRST_INDEX
First data index to process
-l LAST_INDEX, --last_index LAST_INDEX
Last data index to process (-1 to process all the
frames)
-s STEP_INDEX, --step_index STEP_INDEX
Sequence step
-sd STEP_DATA_INDEX, --step_data_index STEP_DATA_INDEX
Sequence data step
-b BASELINE, --baseline BASELINE
Baseline of the stereo system (use this option to
override the baseline value stored in the NetCDF file)
--zmin ZMIN Minimum 3D point elevation (used for colorbar limits)
--zmax ZMAX Maximum 3D point elevation (used for colorbar limits)
--alpha ALPHA Surface transparency [0..1] (default 0.5)
--pxscale PXSCALE A scale factor to apply between logical and physical
pixels in addition to the actual scale factor
determined by the backend. (default 1)
--text_prefix TEXT_PREFIX
Bottom overlay text prefix
--wireframe Render surface in wireframe (default)
--upscale2x Upscale the input image before rendering
--applymask Apply user-defined mask if available
--no-wireframe Render shaded surface
--no-textoverlay Add text overlay at the bottom of the frame
--savexyz Save mapping between image pixels and 3D coordinates
as numpy data file
--create-texture Compute sea surface radiance for each grid point and
store it into the input NetCDF file.
--save-texture Save each sea surface radiance texture to a png image
(data is also stored in the NetCDF)
--saveimg Save the undistorted image (without the superimposed
grid)
--ffmpeg Call ffmpeg to create a sequence video file
--ffmpeg-delete-frames
Delete the produced frames after running ffmpeg
--ffmpeg-fps FFMPEG_FPS
Sequence framerate
For example, the command:
$ python wassncplot.py ./wass_20140327_0910/3D/wass__20140327_091000.nc ./out
Will render the sequence stored in ./wass_20140327_0910/3D/wass__20140327_091000.nc to the directory ./out.
Copyright (C) 2019-2022 Filippo Bergamasco
wassncplot is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.
WASS is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.
You should have received a copy of the GNU General Public License
along with this program. If not, see <http://www.gnu.org/licenses/>.