Welcome to the MEDCoupling Tutorials repository. This project provides learning materials and practical examples to help you get started with MEDCoupling and explore its capabilities.
These tutorials are designed to be used alongside the MEDCoupling reference manual, which provides the full API documentation and detailed descriptions of available methods.
This repository is organized as follows:
- Course slides (source):
./presentations/src - Course slides (PDF):
./presentations/install - Jupyter notebook tutorials:
./tutorials - Visualization utilities:
./src/medcoupling_tutos/- Includes helper tools to convert MEDCoupling meshes and fields into
pyvistaobjects for inline visualization in notebooks.
- Includes helper tools to convert MEDCoupling meshes and fields into
You have two main options:
- Use MEDCoupling via Salome and manually install the required Python
dependencies (
numpy,jupyterlab,pyvista, etc.). - Use the simplified setup below (recommended), which relies on
uvfor environment and dependency management.
Most distributions already include:
curlgit
# Install uv (fast Python package and environment manager)
curl -LsSf https://astral.sh/uv/install.sh | sh
# Clone the repository
git clone https://github.com/SalomePlatform/MEDCoupling_tutos.git
cd MEDCoupling_tutos
# Create environment and install dependencies
uv sync --python 3.12git(must be installed beforehand)
Install uv:
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"Clone the repository and install dependencies:
git clone https://github.com/SalomePlatform/MEDCoupling_tutos.git
cd MEDCoupling_tutos
uv sync --python 3.12Start JupyterLab to explore the notebooks:
cd tutorials
uv run jupyter-labThen open the notebooks from your browser and follow the tutorials interactively. You should use the MEDCoupling documentation alongside the tutorials.
Contributions are welcome! Feel free to open issues or submit pull requests to improve tutorials, fix bugs, or extend functionality.