The graphical user interface of Kratos Multiphysics for GiD, distributed as a GiD problemtype (kratos.gid).
- Stable release: open GiD, go to Data > Problem type > Internet retrieve and download Kratos. Available for Linux, Windows and macOS.
- Developer version: you are in the right place.
Current version: Kratos 10.4.3 — requires GiD 16.1.10d or newer (developer version recommended).
- Clone this repository, or download a release.
- Install the latest GiD developer version (minimum 16.1.10d).
- Go to GiD's
problemtypesfolder and delete any previouskratos.gid. - Create there a link to the
kratos.gidfolder of this repository:- Windows: a shortcut to the
kratos.gidfolder. - Linux / macOS:
ln -s /path/to/GiDInterface/kratos.gid /path/to/GiD/problemtypes/kratos.gid
- Windows: a shortcut to the
- Choose an execution mode (see below).
Select the mode in Kratos > Preferences.
| Mode | What you need | Notes |
|---|---|---|
| GiD's python (default) | Nothing | Uses the Python bundled with GiD. Missing packages are detected and can be installed from the interface. |
| Pip packages | Python + KratosMultiphysics[all] |
Use a Python version supported by the KratosMultiphysics 10.4.3 wheels. |
| Local compiled | Your own Kratos build | For Kratos developers. |
| Docker | Docker | No other dependency. Currently the only option on macOS. Default image: fjgarate/kratos-run. |
If some package is missing, run this in the GiD command line:
-np- W [GiD_Python_PipInstall { $::Kratos::pip_packages_required } 1 ]
# Linux python3 -m pip install --upgrade --force-reinstall --no-cache-dir KratosMultiphysics[all]==10.4.3 # Windows python -m pip install --upgrade --force-reinstall --no-cache-dir KratosMultiphysics[all]==10.4.3
In Kratos > Preferences fill in:
- the path to the Python folder
- the path to the Kratos build folder
Step-by-step video: https://www.youtube.com/watch?v=zZq7ypDdudo
- Run GiD.
- Data > Problem type > kratos.
- Kratos > Preferences > Developer mode (recommended for developers).
- Pick an application in the application market window.
Many applications also ship ready-to-run examples (Examples tool inside the interface).
Public applications (shown in the application market): Structural, Fluid, FSI, Dam, Thermic, Pfem, DEM, MPM, Shallow water, GeoMechanics, and the tools Stenosis Wizard, Stent, Mdpa Generator and Examples.
Others (CompressibleFluid, EmbeddedFluid, Buoyancy, ConjugateHeatTransfer, PfemFluid, CDEM, …) are reachable through the launchers or in developer mode. The full list lives in the appLink entries of kratos.gid/kratos.spd.
kratos.gid/ The GiD problemtype
kratos.tcl Entry point (GiD events, init, version checks)
kratos.xml Problemtype metadata (version, min GiD version, pip packages)
kratos.spd Root of the data tree; lists the applications (appLink)
kratos.transform Rules to upgrade models saved with older versions
apps/<App>/ One folder per application: app.json, start.tcl, xml/, write/, examples/
apps/Common/ Shared XML/SPD definitions
scripts/ Core: Model/ (entities), Writing/ (mdpa + json), Controllers/ (windows)
exec/ Launch scripts per mode and OS, MainKratos.py
libs/ Third-party Tcl libraries
tools/ Release scripts
dockers/ Release / runner docker images
CI runs the kratos-gid-tester suite in the fjgarate/kratos-tester image on a self-hosted runner, on every push to master. Pull requests are tested only after a maintainer adds the safe-to-test label.
- Fork the repository and create a branch from
master. - Make your changes and test them in GiD (see AGENTS.md for the code structure and conventions).
- Open a pull request against
master.
Questions: open an issue.
See LICENSE.md.