Skip to content

Repository files navigation

IBEX logo

IBEX — IMAS variaBles EXplorer

Backend pytest Frontend build & packaging License: LGPL v3

IBEX is a general purpose graphical tool for exploring the content of IMAS structured data (IDS). It displays quantities as 1D or 2D plots — including slicing through higher-dimensionality datasets — and lets you interactively inspect, compare, and manipulate signals from one or more data entries. IBEX is expected to replace IMASViz (which is no longer maintained) and go beyond it.

Documentation: https://imas-ibex.readthedocs.io/

Frontend readme · Backend readme

Quick Start

Prerequisites

  • Python 3.9+
  • Node.js 16+

Installation & Build

git clone <ibex_repo>
cd ibex/backend
python -m venv ibex_venv
source ibex_venv/bin/activate
pip install .

cd ../frontend
npm install
npm run package

Run IBEX

./out/ibex-linux-x64/ibex

Developer Installation

installation on SDCC

    git clone <ibex_repo>
    cd ibex
    
    # this script packs frontend and prepares site-packages with backend
    ./install.sh

    # test if it runs successfully
    ./frontend/out/ibex-linux-x64/ibex

Run IBEX on SDCC

    # first you have to install ibex as shown in step "Central installation on SDCC"
    ./<ibex_repo>/launch.sh

Development run

    git clone <ibex_repo>
    cd ibex
    
    # this script creates venv, installs python package in editable mode and runs fronend
	module load IMAS-Python IDStools nodejs
    ./launch-dev.sh

🚧 Project Status

IBEX is under active development. Core exploration, plotting, and data manipulation workflows are functional, but important changes — including to the backend endpoint API — may still occur between releases. Expect fast iteration, and please report issues or gaps you encounter via GitHub Issues.

TODO / Roadmap

  • Improve performance and reactivity
  • UX friendliness
  • Plots parametrization
  • Use as a webapp (linked to SimDB-Dashboard)

Want to help? See CONTRIBUTING.md to get started.

Releases

Packages

Contributors

Languages