Superpunto is a fast sphere visualizer with superb light effects. Via a simple format (similar to the XYZ format) one can visualize the trajectories of a large number of spherical particles in an interactive way.
Superpunto was born as a SDL2/OpenGL4.5 clone of mrevenga's SDL punto ( http://punto.sourceforge.net/ )
Superpunto is available in conda as a conda-forge package. You can install it using the following command:
conda install -c conda-forge superpuntoThe Github release page offers prebuilt binaries for Linux in the form of AppImages. These are self-contained executables that include all the necessary libraries and dependencies to run the application.
You can copy paste this command in your terminal to download and place into your PATH the latest one, after which the command "spunto" will be available.
mkdir -p ~/.local/bin && curl -L https://github.com/RaulPPelaez/superpunto/releases/latest/download/spunto-x86_64.AppImage -o ~/.local/bin/spunto && chmod +x ~/.local/bin/spuntoPrebuilt AppImages are generated automatically for each release. You can see them in the Releases page.
To run the AppImage:
chmod +x spunto-x86_64.AppImage
./spunto-x86_64.AppImageRuns on most Linux distributions (glibc ≥ 2.31)
You can place the AppImage somewhere in your PATH for easier access:
cp spunto-x86_64.AppImage ~/.local/bin/spuntoThen you can run it from anywhere.
If you prefer to build the project yourself, there are multiple supported options:
git clone https://github.com/RaulPPelaez/superpunto.git
cd superpuntoMake sure you have the following dependencies installed:
- CMake
- C++ Compiler (g++, clang++)
- OpenGL 4.5
- SDL2
- SDL2_ttf
- libGLEW
- libPNG
- (Optional) ffmpeg for recording
You can install these dependencies using your package manager. For example, on Ubuntu:
$ sudo apt install cmake g++ libsdl2-dev libsdl2-ttf-dev libglew-dev libpng-dev ffmpegOr in Fedora:
$ sudo dnf install SDL2-devel SDL2_ttf-devel libpng-devel libGLEW ffmpeg glew-develOr use the provided environment.yml file to create a Conda environment:
conda env create -f environment.yml
conda activate spunto-envCompile
Superpunto is built using CMake. You can build it in a separate directory:
mkdir build
cd build
cmake ..
make -j installIf you want to install it system-wide, you will need to run the make install command with sudo:
sudo make installIf using conda, you must instruct CMake to use the conda paths:
cmake -DCMAKE_PREFIX_PATH=$CONDA_PREFIX -DCMAKE_PREFIX_PATH=$CONDA_PREFIX ..Build the AppImage
If you want to build the AppImage, you can do so by adding the -DBUILD_APPIMAGE=ON option to the CMake command:
cmake -DBUILD_APPIMAGE=ON ..Run with
$ ./spunto inputfile [opts]Run spunto -h for information about the available options and controls.
The inputfile should have the following structure:
#Lx=X;Ly=Y;Lz=Z; Comments are used to separate frames, you can force the size of the simulation box starting the comment as in this example. All three L must be provided
X1 Y1 Z1 r1 c1 #You can comment here aswell. If your file has more than
X2 ... # 5 columns, the rest will be ignored!
.
.
# frame=2
X1 Y1 Z1 r1 c1
.
.
# frame = 3
The columns correspond to the three dimensional coordinates of each particle (XYZ), the radius (r) and the color (c).
If some of the columns are missing, this is the behavior according to the number of columns:
3: XYZ ->r=1, c=0
4: XYZC -> r=1
The column color can be treated in two ways:
Default or using --palette X
The default palette is "superpunto", which understands colors as an integer number between 0 an 1000. The palette is random inside that range.
Additionally, any palette from matplotlib can be passed to --palette, in which case the color column will be treated as a float between 0 and 1.
RGB by using --RGB
The colors will be treated as an BGR hexadecimal color, i.e. being 255 = 0xFF = red and 16711680 = 0xFF0000 = blue.
Clicking one sphere with the left mouse button will highlight it and print its coordinates. Clicking a second one with the right click will print its coordinates too, in addition to the distance between both.