This repository contains a technology demonstration project from InSimo, based on ISSofa, a version of SOFA that is optimized for the use case of interactive biomechanical simulations.
It also contains:
- ISSofaGUI: a modified version of the GUI originally provided in Sofa's application/sofa/gui directory
- ISSofaPython: a pybind11-based python binding module and plugin compatible with both python 2 and python 3
- ISExternals and SofaWinDependencies: precompiled dependencies (currently only for Windows and Linux)
The project main CMakeLists.txt file is located in the build folder.
See the following document for more detailed instructions.
Use runSofa from the cmake build directory.
ISSofaPythonPlugin needs to be loaded to run python scenes.
A sofa.env file is generated at cmake time that should do it automatically, but if it fails you can load it via the GUI or the -l ISSofaPythonPlugin command line argument.
Sources archives (one per submodule):
OUTPUT="ISSofaDemo-$(date +%F)"
git archive -9 -o "${OUTPUT}.zip" --prefix="${OUTPUT}/" HEAD
git -C IS/ISExternals archive -9 -o "${PWD}/${OUTPUT}_ISExternals.zip" --prefix="${OUTPUT}/IS/ISExternals/" HEAD
git -C IS/SofaWinDependencies archive -9 -o "${PWD}/${OUTPUT}_SofaWinDependencies.zip" --prefix="${OUTPUT}/IS/SofaWinDependencies/" HEADOr with git-archive-all:
pip install git-archive-all
git archive-all -9 -o "ISSofaDemo-$(date +%F).zip" --prefix="ISSofaDemo-$(date +%F)/" HEADOr to create a 7z archive
OUTPUT="ISSofaDemo-$(date +%F)"
mkdir "${OUTPUT}" && git archive HEAD | tar xC "${OUTPUT}" && git submodule foreach "git archive --prefix=\"\$sm_path/\" \$sha1 | tar xC \"${PWD}/${OUTPUT}\"" && 7z a "${OUTPUT}.7z" "${OUTPUT}" && rm -rf "${OUTPUT}"The build configuration can be specified by editing the build/ProjectConfiguration.cmake file
Note: currently we provide versions using python or xml(+php). Ideally, once the python support has stabilized in Sofa, a single (python-based) version would replace the others.
Within the examples folder:
The main multithreading demonstration / benchmark scene.
It requires the ISSofaPythonPlugin plugin to be loaded.
Parameters can be edited at the top of the file, or using environment variables (to run multiple benchmarks for example).
Videos:
This version should work with the public Sofa version (tested with v20.06.01).
Note that a patch for BarycentricMapping is currently required (until PR #TODO is merged)
The .pscn file can be customized but to load it runSofa requires the php console application to be installed and available on the PATH.
This version is the same as the SofaPublic version with the component names amended when needed to be able to run with ISSofa. It can be used for apple-to-apple comparison between the two Sofa versions (could be useful to investigate performance regressions).
ISSofa is LGPL, except:
- applications/projects (GPL)
- sub-directories with a license file specifying a different license
ISSofaPython is LGPL.
ISSofaGUI is GPL.
LGPL refers to the GNU Lesser General Public License as published by the Free Software Foundation; either version 2.1 of the License, or (at your option) any later version.
GPL refers to the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.