The parPE library provides functionality for solving large-scale parameter optimization problems requiring up to thousands of simulations per objective function evaluation on HPC systems.
parPE offers easy integration with AMICI-generated ordinary differential equation (ODE) models.
parPE offers the following features:
- MPI-based load-balancing of individual simulations
- improved load balancing by intermingling multiple optimization runs (multi-start local optimization)
- simple integration with SBML models via AMICI and PEtab
- interfaces to Ipopt, Ceres, FFSQP and SUMSL (CALGO/TOMS 611) optimizers
- HDF5 I/O compatible with a wide variety of programming languages
- Good parallel scaling to up to several thousand cores (highly problem dependent)
Although various modules of parPE can be used independently, the most meaningful and convenient use case is parameter optimization for an SBML model specified in the PEtab format. This is described in doc/petab_model_import.md.
For full functionality, parPE requires the following libraries:
- CMAKE (>=3.6)
- MPI (OpenMPI, MPICH, ...)
- PTHREADS
- IPOPT (>= 1.2.7) (requires coinhsl)
- CERES (>=1.13) (requires Eigen)
- HDF5 (>= 1.10)
- CBLAS compatible BLAS (libcblas, Intel MKL, ...)
- AMICI (included in this repository) (uses SuiteSparse, Sundials)
- C++14 compiler
- Python >= 3.6, including header files
On Debian-based systems, dependencies can be installed via:
sudo apt-get install build-essential gfortran libmpich-dev libblas-dev \
libhdf5-dev cmake libceres-dev coinor-libipopt-dev libcpputest-dev \
libboost-serialization-dev libpython-dev
Scripts to fetch and build the remaining dependencies are provided in
/ThirdParty/:
cd ThirdParty
./downloadPackages.sh
./installDeps.sh
NOTE: When using ThirdParty/installIpopt.sh to build Ipopt, follow the
instructions in ThirdParty/Ipopt-3.12.12/ThirdParty/HSL/INSTALL.HSL for
obtaining the hsl library before continuing, otherwise IpOpt will not be
usable. Afterwards, (re)run ThirdParty/installIpopt.sh.
After having taken care of the dependencies listed above, parPE can be built:
./build.sh
Other sample build scripts are provided as /build*.sh.
- GCC 8.3.0
- Intel icpc (ICC) 17.0.6
Some high-level documentation is provided in doc/ and among
Github issues. No extensive
full-text documentation is available for the C++ interface yet. For usage of
the C++ interface see examples/ and */tests.
parPE is being used or has been used in the following projects:
-
Leonard Schmiester, Yannik Schälte, Fabian Fröhlich, Jan Hasenauer, Daniel Weindl. Efficient parameterization of large-scale dynamic models based on relative measurements. bioRxiv 2018. doi:10.1101/579045