ARES depends on:
If you have mercurial installed, you can clone ARES and its entire revision history via:
hg clone https://bitbucket.org/mirochaj/ares ares cd ares python setup.py install
If you do not have mercurial installed, and would rather just grab a tarball of the most recent version, select the Download repository option on bitbucket.
You’ll need to set an environment variable which points to the ARES install directory, e.g. (in bash)
ARES will look in
$ARES/input for lookup tables of various kinds. To download said lookup tables, run
This might take a few minutes. If something goes wrong with the download, you can run
python remote.py fresh
to get fresh copies of everything. If you’re concerned that a download may have been interrupted and/or the file appears to be corrupted (strange I/O errors may indicate this), you can also just download fresh copies of the particular file you want to replace. For example, to grab a fresh initial conditions file, simply do
python remote.py fresh inits
ARES has two main branches. The first,
default, is meant to be stable, and will only be updated with critical bug fixes or upon arrival at major development milestones. The “bleeding edge” lives in the
ares-dev branch, and while you are more likely to find bugs in
ares-dev, you will also find the newest features.
By default after you clone ARES you’ll be using the
default branch. To switch, simply type:
hg update ares-dev
To switch back,
hg update default
For a discussion of the pros and cons of different branching techniques in mercurial, this article is a nice place to start.
The first stable release of ARES was used in Mirocha et al. (2015), and is tagged as v0.1 in the revision history. The tag v0.2 is associated with Mirocha, Furlanetto, & Sun (2017). Note that these tags are just shortcuts to specific revisions. You can switch between them just like you would switch between branches, e.g.,
hg update v0.2
If you’re unsure which version is best for you, see the Development History.
Don’t have Python already?¶
If you do not already have Python installed, you might consider downloading yt, which has a convenient installation script that will download and install Python and many commonly-used Python packages for you. Anaconda is also good for this.