MacOS Bundles

Please make sure you download the correct version on the download page.

It is still necessary to install apple's command line tools. However, this version does not depend on Fink or Homebrew and doesn't require compilation. To install the command line tools try to run clang in a terminal and click install in the window that opens. If that does not work then run xcode-select –install in a terminal. You can also install the full XCode IDE from the app store, but this takes about 20 times more disk space than the command line tools.

Installation of the bundle works as for any other Mac app that does not come via the app store:

• Mount the disk image.
• Drag the polymake application to a folder of your choice on your hard disk (the common choice would be the /Applications folder).
• Start polymake by double clicking the icon.

The disk image also contains a README file with some more detailed instructions, and the corresponding sources.

Note that the application is not a true Mac application. It just opens a Terminal and starts polymake. This implies the following limitations:

• It does not appear in the Dock, or in the list of running applications.
• Clicking the icon again always opens a new instance of polymake instead of switching to a running instance.
• It is not relocatable. After you started polymake once you have to reset the customization of polymake and all extensions if you want to move the app to a different folder. See the README for more details.

The bundle comes with a still experimental support for starting polymake in a jupyter notebook. To use it you need to install python3 and jupyter yourself and make sure polymake can find both in the path (usually python is found with the default path, only jupyter needs to be added. You have two options for this: add the path to the $PATH variable in .bash_profile, or add the path to the variable POLYMAKE_ADD_PATH in the file$HOME/.polymake-macbundle/bundle.config created after the first start of the bundle.) To use polymake in a jupyter notebook, start the bundle at least once and exit, then set POLYMAKE_START_IN_JUPYTER to 1 in $HOME/.polymake-macbundle/bundle.config, and start polymake again. It should ask your confirmation to install the kernel and then start a browser with jupyter.

On Mac OS 10.11 you need at least clang version 8 (for Julia, and thus also for polymake in Julia).

You can use the bundle together with Polymake.jl in Julia. You need however to prepare your Julia. Note however that this is still an experimental feature and may fail on your system. We value feedback on this!

Start both Julia and the bundle at least once to create the user configuration directories.

Download this file and save it to a location on your computer. Open a terminal and do

mkdir -p $HOME/.julia/config
echo 'include("/path/to/file/polymake_start_julia.jl")' >> $HOME/.julia/config/startup.jl

where /path/to/file should be the full path (so starting with /Users) to the file you downloaded.

Now start julia and hopefully it downloads and compiles Polymake.jl, linking it against the bundle.

You can build your own version of the bundle with the following steps. The only prerequisite is Xcode, which you can easily install via the app store. Then open a Terminal (in the utilities folder of Applications) and type the following commands (if you want to you can first switch into a different folder):

git clone https://github.com/polymake/polybundle.git 
cd polybundle
./build_bundle
open -R .

The third command will take a long while. Here, all required software packages are downloaded and installed, so you need a working connection to the internet during this step. The last command opens a finder window of the folder polymake is compiled in. If everything worked you will find the polymake app (look for the logo) in that folder. You can either drag this to /Applications or start directly from this folder by double clicking.

The same usage hints as for the precompiled binaries above apply also to this version.