Skip to content

Commit

Permalink
update getting started notebook for conda
Browse files Browse the repository at this point in the history
  • Loading branch information
bstabler committed Nov 9, 2021
1 parent 1cfbd3b commit faf9dc9
Showing 1 changed file with 25 additions and 5 deletions.
30 changes: 25 additions & 5 deletions activitysim/examples/example_mtc/notebooks/getting_started.ipynb
Original file line number Diff line number Diff line change
Expand Up @@ -30,7 +30,7 @@
"source": [
"# Install ActivitySim\n",
"\n",
"The first step is to install activitysim from [pypi](https://pypi.org/project/activitysim/) (the Python package index). It also installs dependent packages such as [tables](https://pypi.org/project/tables/) for reading/writing HDF5, [openmatrix](https://pypi.org/project/OpenMatrix/) for reading/writing OMX matrix, and [pyyaml](https://pypi.org/project/PyYAML/) for yaml settings files."
"The first step is to install activitysim from [conda forge](https://anaconda.org/conda-forge/activitysim). This also installs dependent packages such as [tables](https://pypi.org/project/tables/) for reading/writing HDF5, [openmatrix](https://pypi.org/project/OpenMatrix/) for reading/writing OMX matrix, and [pyyaml](https://pypi.org/project/PyYAML/) for yaml settings files. The command below also creates an asim [conda environment](https://conda.io/projects/conda/en/latest/user-guide/concepts/environments.html) just for activitysim."
]
},
{
Expand All @@ -47,7 +47,26 @@
},
"outputs": [],
"source": [
"!pip install activitysim"
"!conda create -n asim python=3.9 activitysim -c conda-forge --override-channels"
]
},
{
"cell_type": "markdown",
"metadata": {
"colab_type": "text",
"id": "5Tid_70tVBlc"
},
"source": [
"# Activate the Environment"
]
},
{
"cell_type": "code",
"execution_count": null,
"metadata": {},
"outputs": [],
"source": [
"!conda activate asim"
]
},
{
Expand Down Expand Up @@ -9355,6 +9374,7 @@
"```\n",
"num_processes: 2\n",
"chunk_size: 0\n",
"chunk_training_mode: disabled\n",
"\n",
"multiprocess_steps:\n",
" - name: mp_initialize\n",
Expand All @@ -9370,7 +9390,7 @@
"\n",
"```\n",
"\n",
"In brief, `num_processes` specifies the number of processors to use and a `chunk_size` of `0` means ActivitySim is free to use all the available RAM if needed. The `multiprocess_steps` specifies the beginning, middle, and end steps in multiprocessing. The `mp_initialize` step is single processed because there is no `slice` setting. It starts with the `initialize_landuse` submodel and runs until the submodel identified by the next multiprocess submodel starting point, `school_location`. The `mp_households` step is multiprocessed and the households and persons tables are sliced and allocated to processes using the chunking settings. The rest of the submodels are run multiprocessed until the final multiprocess step. The `mp_summarize` step is single processed because there is no `slice` setting and it writes outputs. See [multiprocessing](https://activitysim.github.io/activitysim/core.html#multiprocessing) and [chunk_size](https://activitysim.github.io/activitysim/core.html#chunk) for more information. "
"In brief, `num_processes` specifies the number of processors to use and a `chunk_size` of `0` plus a `chunk_training_mode` of `disabled` means ActivitySim is free to use all the available RAM if needed. The `multiprocess_steps` specifies the beginning, middle, and end steps in multiprocessing. The `mp_initialize` step is single processed because there is no `slice` setting. It starts with the `initialize_landuse` submodel and runs until the submodel identified by the next multiprocess submodel starting point, `school_location`. The `mp_households` step is multiprocessed and the households and persons tables are sliced and allocated to processes using the chunking settings. The rest of the submodels are run multiprocessed until the final multiprocess step. The `mp_summarize` step is single processed because there is no `slice` setting and it writes outputs. See [multiprocessing](https://activitysim.github.io/activitysim/core.html#multiprocessing) and [chunk_size](https://activitysim.github.io/activitysim/core.html#chunk) for more information. "
]
},
{
Expand Down Expand Up @@ -9629,7 +9649,7 @@
"toc_visible": true
},
"kernelspec": {
"display_name": "Python 3",
"display_name": "Python 3 (ipykernel)",
"language": "python",
"name": "python3"
},
Expand All @@ -9643,7 +9663,7 @@
"name": "python",
"nbconvert_exporter": "python",
"pygments_lexer": "ipython3",
"version": "3.8.10"
"version": "3.9.7"
}
},
"nbformat": 4,
Expand Down

0 comments on commit faf9dc9

Please sign in to comment.