Contents:

• What makes up Mathics?
  • Mathics Core
  • Mathics Character Tables and Tokenizer
  • Mathics Syntax Highlighting
  • mathicsscript
  • Django-based GUI
  • PyMathics Modules
    • Natural Language Python Module add-on
    • Graph Python Module add-on
    • Matplotlib Python Module Backend Renderer
    • Asymptote Python Module Backend Renderer

Installing Mathics

Here we describe the various ways to get Mathics installed.

Install from PyPI

Here is how you can install the full Mathics suites:

$ pip install Mathics-omnibus[full]

This install these suite of independent Mathics3 packages:

• mathicsscript

• mathics-django

• pymathics-graph, pymathics-natlang

These in turn pull in two other Mathics3 packages:

• mathics-scanner

• mathics-core

In other words, this package doesn’t have any code in it. Instead it just contains dependencies to other PyPI Mathics packages.of other PyPI package. It is more or less equivalent to:

$ pip install Mathics3  # this is the core engine. It is a dependency of some of the below too
$ pip install Mathics-Django[full] # web front-end with extras
$ pip install mathicsscript[full]  # the command-line interface with extras
$ pip install pymathics-natlang # the Natural-language Python module
$ pip install pymathics-graph # the Python module for working with Graphs and Networks

Note the name is “Mathics3” for the most recent release. “Mathics” has pre-Python 3 code.

Other sections fhave descriptions of the various pieces, what features they add and what dependencies are needed to run them.

If you want mathics-core to include modules that have been run through Cython, then install Cython separately:

$ pip install cython

Install from Conda-Forge

See https://github.com/conda-forge/mathics3-feedstock.

At present, the Conda Forge Mathics release is for an older version.

From docker (dockerhub)

As an alternative to building all the components from source or via Python package, you can run pre-built code for all of the components via docker. To download a copy of the docker image run:

$ docker pull mathicsorg/mathics

This will pull the latest development release that has a docker tagname #latest if you want a stable release, give the version in the pull command. For example

$ docker pull mathicsorg/mathics#4.0.0

From an OS-specific Repository

Click on the link below from Repology.org for details for a specific OS and distribution.

Install from git from github

If you need the most recent fixes, you can install from github. Note that there isn’t a single github repository that contains everything.

Also, since Mathics is in constant flux, dependencies can change. The development version from might require development version from another.

These instructions then aren’t complete and may need to be adapted for the various Mathics3 github repositories

Requirements

The Mathics suite runs on Python 3.6 or later. We also support PyPy 3.6 or later.

Underneath, Mathics core relies on sympy which relies on numpy. These and the other requirements will be installed automatically if you use the standard Python installer pip. They are also listed in setup.py.

SciPy is optional. It is used for images and provides alternative implementations for a number of builtins.

Buiding the PDF documentation has a number of additional dependencies.

• xetex 3.14159265-2.6-0.999991 or greater

• asymptote, 2.71-37 or greater

• ghostscript Version 9.54.0 or greater

Pay close attention to the version. Some OS-provided packages have bugs in them that will prevent certain images like those involving opacity (used in Filling) not to render.

The above dependencies are for Mathics core only. Mathics-Django, mathicsscript and PyMathics modules have their own set of dependencies.

OS-dependent packages

For the installation above you may need OS-specific packages.

For Debian/Ubuntu based systems:

$ apt-get install python-dev libsqlite3-devp python-setuptools

as super-user, i.e. either after having issued su or by preceding the command with sudo).

Note that to build the PDF, you will need asymptote and .deb package has a couple of bugs that will cause some graphs with opacity to fail. Asymptote version 2.71 or later is recommended. I build this from the git source.

Also ghostscript is needed and 9.50 has bugs in it too that will cause failures in rendering Asymptote images. Use 9.54 or later.

On Mac OS X:

$ brew install sqlite3

On FreeBSD:

$ sudo pkg install math/py-mathics