# Getting Started¶

## Quick Start¶

If you already have conda installed, you can install Larch from conda-forge in a new environment called arboretum like this:

conda create -n arboretum -c conda-forge larch


## Installing Python¶

To run Larch, you’ll need to have the 64 bit version of Python 3.7, plus a handful of other useful statistical packages for Python. The easiest way to get the basics is to download and install the Anaconda version of Python 3.7 (64 bit). This comes with everything you’ll need to get started, and the Anaconda folks have helpfully curated a selection of useful tools for you, so you don’t have the sort through the huge pile of junk that is available for Python.

Note

Python has two versions (2 and 3) that are available and currently maintained. Larch is compatible only with version 3.

You should usually install Anaconda for the local user, which does not require administrator permissions. You can also install Anaconda system wide, which does require administrator permissions – but even if you have those permissions, you may find that installing only for one user prevents problems arising over multiple users editing common packages.

If you already have Python installed, either by itself or as a companion to any one of a variety of common transportation planning tools (e.g., ArcGIS), you can still install and use Anaconda. You do not need to uninstall, move, or change any existing Python installation. Just use the standard Anaconda installer and let the installer add the conda installation of Python to your PATH environment variable. There is no need to set the PYTHONPATH environment variable.

Once Anaconda is installed, it can be accessed from the Anaconda Prompt (on Windows) or the Terminal (linux and macOS).

## Managing Environments¶

When you use conda to install Python, by default a base environment is created and packages are installed in that environment. However, in general you should almost never undertake project work in the base environment, especially if your project involves installing any custom Python packages. Instead, you should create a new environment for each project, and install the necessary packages and dependencies in that environment. This will help prevent software conflicts, and ensure that tools installed for one project will not break another project.

Note

The instructions below provide only the most basic steps to set up and use an environment. Much more extensive documentation on managing environments is available in the conda documentation itself.

If you’d like one command to just install Larch and a suite of related tools relevant for transportation planning and discrete choice analysis, you can create a new environment for Larch with one line.

conda env create jpn/taiga


Note

If you installed the “Miniconda” version of the anaconda package, you may need to install or update the conda and anaconda-client packages before the remote environment installation command above will work:

conda install -n base -c defaults conda anaconda-client


If you’ve already installed the taiga environment and want to update it to the latest version, you can use:

conda env update jpn/taiga --prune


The prune option here will remove packages that are not ordinarily included in the taiga environment; omit that function if you’ve installed extra packages that you want to keep.

Then you can skip directly to using an environment.

### Using an Environment¶

When using the terminal (MacOS/Linux) or an Anaconda Prompt (Windows), the current environment name will be shown as part of the prompt:

(base) Computer:~ cfinley$ By default, when opening a new terminal the environment is set as the base environment, although this is typically not where you want to be if you have followed the advice above. Instead, to switch environments use the conda activate command. For example, to activate the taiga environment installed in the quick start, run: (base) Computer:~ cfinley$ conda activate taiga
(taiga) Computer:~ cfinley\$


## Running Jupyter¶

The most convenient interface for interactive use of Larch is within JupyterLab. If it’s not already installed in your base or working environments, you can install it using conda:

conda install -c conda-forge jupyterlab


Then to start JupyterLab,

jupyter lab


JupyterLab will open automatically in your browser.