PyTolosa System Requirements

System Requirements

Environment

The following environment variable needs to be added to your ~/.bash_profile, or before executing PyTolosa:

export QT_QPA_PLATFORM='offscreen'

Python Version

PyTolosa requires Python 3.7 or later.

Required Python Packages

The Python libraries and packages needed to use PyTolosa are:

Core Dependencies

• Matplotlib - Creates static, animated, and interactive visualizations in Python
• NumPy - Fundamental package for scientific computing in Python
• SciPy - Collection of open source software for scientific computing in Python
• CSV - Implements classes to read and write tabular data in CSV format

Optional Dependencies

• mpi4py - Provides bindings of the Message Passing Interface (MPI) standard, allowing any Python program to exploit multiple processors (for parallel post-processing)
• argparse - Writes user-friendly command-line interfaces
• termcolor - ANSII Color formatting for output in terminal

Animation Tools

You should also install FFMPEG to create animations of post-treated results.

Installation

Using pip

# Install core dependencies
pip install matplotlib numpy scipy

# Install optional dependencies for parallel processing
pip install mpi4py

# Install termcolor for colored terminal output
pip install termcolor

Using conda

# Create a new environment
conda create -n pytolosa python=3.9

# Activate the environment
conda activate pytolosa

# Install dependencies
conda install matplotlib numpy scipy mpi4py

# Install FFMPEG
conda install ffmpeg

FFMPEG Installation

Linux (Ubuntu/Debian)

sudo apt-get update
sudo apt-get install ffmpeg

macOS

brew install ffmpeg

Verify Installation

ffmpeg -version

Verification

To verify your Python environment:

python3 -c "import matplotlib, numpy, scipy; print('All core packages installed!')"

For MPI support:

python3 -c "import mpi4py; print('MPI support available!')"

Next Steps

• Downloading - Get the PyTolosa source code
• Running PyTolosa - Usage examples