Paramotopy is command line software for repeated solving parameterized polynomial systems using Bertini.
Bertini 1 offers a built-in parameter homotopy. But it solves only at one parameter point at a time. Paramotopy essentially implements the loop you'd have to write, if you wanted to use Bertini's parameter homotopy many times. Plus, Paramotopy includes tools for resolving path failures, etc, be re-solving at just those parameter points. Nifty!
The main website for paramotopy is at paramotopy.com. There are some examples, and some guidance. The manual pdf is located in this repo, in the documentation/source folder. I know, it's not source. Feel free to help me out in providing a better build system for it than manual tex-ing.
Paramotopy requires several libraries to successfully install. These libraries are:
- mpfr
- gmp
- bertini-serial
- boost (>= 1.53)
- mpich3
important note: Bertini must have been built and installed from source
If these libraries have been installed in standard locations, e.g. /usr/local/include for header files and /usr/local/lib for library files, then the command
./configure
will work fine.
If you have the libraries installed in non-standard locations, you may need to add each location of the headers to the CPPFLAGS variable and the location of the libraries to the LDFLAGS variable. For example, if you have mpfr, gmp, and bertini installed in /usr/local/mpfr, /usr/local/gmp, and /usr/local/bertini, respectively, then you would run
./configure CPPFLAGS="-I/usr/local/mpfr/include -I/usr/local/gmp/include -I/usr/local/bertini/include" LDFLAGS="-L/usr/local/mpfr/lib -L/usr/local/gmp/lib -L/usr/local/bertini/lib"
In this case, you probably also will also need to add the location of the Bertini library to LD_RUN_PATH and LD_LIBRARY_PATH.
If you are wanting to install with a particular compiler, or your compiler is not in the PATH location, you will need to run
./configure CXX="/path/to/g++" MPICXX="/path/to/mpic++"
If you have non-standard locations for libraries and a specific compiler to use, you can run, for instance
./configure CXX="/path/to/g++" MPICXX="/path/to/mpic++" CPPFLAGS="-I/usr/local/mpfr/include -I/usr/local/gmp/include -I/usr/local/bertini/include" LDFLAGS="-L/usr/local/mpfr/lib -L/usr/local/gmp/lib -L/usr/local/bertini/lib"
Additional compiler flags can be added to CPPFLAGS, if desired.
After ./configure [OPTIONS] has successfully ran, then you can install paramotopy with
make; make install
Silviana builds on MacOS, using Homebrew.
- use this to make the gnu tools installed by Homebrew supercede those provided by Mac:
PATH="$(brew --prefix)/opt/gnu-tar/libexec/gnubin:$PATH"
- use this to make
tarnot fail when runningmake dist:
export TAR_OPTIONS = --owner=0 --group=0 --numeric-owner
note: an improvement would be to move to CMake, but I have no time for that right now.