deploy: 2e5f732

Author: jpn--

develop/.buildinfo

@@ -1,4 +1,4 @@
 # Sphinx build info version 1
 # This file hashes the configuration used when building these files. When it is not found, a full rebuild will be done.
-config: 67a20199e7194cae59a31d6b222bc052
+config: f02da933e5ef1e2e6b3a237e0efef7ea
 tags: 645f666f9bcd5a90fca523b33c5a78b7

develop/_sources/dev-guide/build-docs.md.txt

@@ -15,21 +15,16 @@ them into html as well.  ActivitySim's docstrings are written in
 ## Building the Documentation
 
 Developers who want to test a build of the ActivitySim documentation locally can
-do so using `sphinx`.  A pre-packaged conda environment is available to simplify this
-process. On the command line, starting from the `activitysim` directory that constitutes the
-main repository (i.e. you should see subdirectories including `activitysim`,
-`conda-environments`, `docs`, and a few others) run these commands:
+do so using `sphinx`. The *uv* `dev` environment includes the required dependencies. On the command line, starting from the `activitysim` directory that constitutes the
+main repository (i.e. you should see subdirectories including `activitysim`, `docs`, and a few others) run these commands:
 
 ```bash
-mkdir -p ../.env
-mamba env update -p ../.env/DOCBUILD -f conda-environments/docbuild.yml
-conda activate ../.env/DOCBUILD
 cd docs
 make clean
 make html
 ```
 
-This will build the docs in the `docs/_build/html` directory.  They can be viewed
+This will build the docs in the `docs/_build/html` directory. They can be viewed
 in a web browser using the `file:///` protocol, or by double-clicking on the
 `index.html` file (or any other .html file in that directory).
 

develop/_sources/dev-guide/install.md.txt

@@ -1,73 +1,20 @@
 (developer-installation)=
 # Developer Installation
 
-Installing ActivitySim as a developer is almost as easy as just using it,
-but making some tweaks to the processes enables live code development and
-testing.
-
-## Package Manager
-
-ActivitySim has a lot of dependencies.  It's easiest and fastest to install
-them using a package manager like conda, or its faster and free sibling
-[Mambaforge](https://github.com/conda-forge/miniforge#mambaforge).
-Depending on your security settings, you might need to install in a
-container like docker, instructions for that are coming soon.
-
-Note that if you are installing `mamba`, you only should install `mamba`
-in the *base* environment. If you install `mamba` itself in other environments,
-it will not function correctly.  If you've got an existing conda installation
-and you want to install mamba into it, you can install mamba into the *base*
-environment like this:
-
-```sh
-conda update conda -n base
-conda install -n base -c conda-forge mamba
-```
-
-While you are at it, if you are a Jupyter user you might want to also install
-`nb_conda_kernels` in your base conda environment alongside any other `jupyter`
-libraries:
-
-```sh
-mamba install -n base nb_conda_kernels -c conda-forge
-```
-
-This will ensure your development environments are selectable as kernels in
-Jupyter Notebook/Lab/Etc.
-
-## Environment
-
-It's convenient to start from a completely clean conda environment
-and git repository. Assuming you have `mamba` installed, and you
-want to install in a new directory called "workspace" run:
-
-```sh
-mkdir workspace
-cd workspace
-mamba env create -p ASIM-ENV --file https://raw.githubusercontent.com/ActivitySim/activitysim/main/conda-environments/activitysim-dev-base.yml
-conda activate ./ASIM-ENV
-git clone https://github.com/ActivitySim/sharrow.git
-python -m pip install -e ./sharrow
-git clone https://github.com/ActivitySim/activitysim.git
-python -m pip install -e ./activitysim
-```
-
-Note the above commands will create an environment with all the
-necessary dependencies, clone both ActivitySim and sharrow from GitHub,
-and `pip install` each of these libraries in editable mode, which
-will allow your code changes to be reflected when running ActivitySim
-in this environment.
+Installing ActivitySim as a developer is as easy as just using it with *uv*.
 
 Depending on what you are working on, you may want to check out a branch
-other than `develop`.  To do so, you can point the `git switch` command
-above to any other existing branch name.  If you want to start an new
+other than the default `main`. To do so, you can use a `git switch` command
+to any other existing branch name. If you want to start an new
 branch, first create it with `git branch cool-new-feature` and then switch
 to it with `git switch cool-new-feature`.
 
-Now your environment should be ready to use.  Happy coding!
+By default, *uv* installs projects in editable mode, such that changes to the 
+source code are immediately reflected in the environment. 
 
 ```{important}
-If you add to the ActivitySim dependencies, make sure to also update
-the environments in `conda-environments`, which are used for testing
-and development.
+If you add to the ActivitySim dependencies during development or remove, make 
+sure to use the `uv add` and `uv remove` commands so that the `pyproject.toml`
+and `uv.lock` files are updated correctly and your virtual environment is 
+updated.
 ```

develop/_sources/users-guide/example_models.rst.txt

@@ -2985,25 +2985,24 @@ Running the model
 
 To run the example, do the following:
 
-* Activate the correct conda environment if needed
 * View the list of available examples
 
 ::
 
-  activitysim create --list
+  uv run activitysim create --list
 
 * Create a local copy of an example folder
 
 ::
 
-  activitysim create --example prototype_mtc --destination my_test_example
+  uv run activitysim create --example prototype_mtc --destination my_test_example
 
 * Run the example
 
 ::
 
   cd my_test_example
-  activitysim run -c configs -d data -o output
+  uv run activitysim run -c configs -d data -o output
 
 
 * ActivitySim will log progress and write outputs to the output folder.
@@ -3019,7 +3018,7 @@ The example should run in a few minutes since it runs a small sample of househol
 
   ::
 
-    python simulation.py
+    uv run simulation.py
 
 .. _multiprocess_example :
 
@@ -3032,7 +3031,7 @@ include the multiprocessing configuration settings via settings file inheritance
 
 ::
 
-  activitysim run -c configs_mp -c configs -d data -o output
+  uv run activitysim run -c configs_mp -c configs -d data -o output
 
 The multiprocessing example also writes outputs to the output folder.
 

develop/_sources/users-guide/model_anatomy.rst.txt

@@ -110,16 +110,15 @@ Examples
 
 To run the two zone and three zone system examples, do the following:
 
-* Activate the correct conda environment if needed
 * Create a local copy of the example
 
 ::
 
   # simple two zone example
-  activitysim create -e placeholder_2_zone -d test_placeholder_2_zone
+  uv run activitysim create -e placeholder_2_zone -d test_placeholder_2_zone
 
   # simple three zone example
-  activitysim create -e placeholder_3_zone -d test_placeholder_3_zone
+  uv run activitysim create -e placeholder_3_zone -d test_placeholder_3_zone
 
 
 * Change to the example directory
@@ -128,11 +127,11 @@ To run the two zone and three zone system examples, do the following:
 ::
 
   # simple two zone example
-  activitysim run -c configs_2_zone -c configs -d data_2 -o output_2
+  uv run activitysim run -c configs_2_zone -c configs -d data_2 -o output_2
 
   # simple three zone example, single process and multiprocess (and makes use of settings file inheritance for running)
-  activitysim run -c configs_3_zone -c configs -d data_3 -o output_3 -s settings_static.yaml
-  activitysim run -c configs_3_zone -c configs -d data_3 -o output_3 -s settings_mp.yaml
+  uv run activitysim run -c configs_3_zone -c configs -d data_3 -o output_3 -s settings_static.yaml
+  uv run activitysim run -c configs_3_zone -c configs -d data_3 -o output_3 -s settings_mp.yaml
 
 Settings
 ~~~~~~~~
@@ -421,7 +420,7 @@ alternatives, coefficients, constants and other settings for each model. For mor
 Outputs
 -------
 
-The key output of ActivitySIm is the HDF5 data pipeline file ``output\pipeline.h5``. This datastore by default contains
+The key output of ActivitySim is the HDF5 data pipeline file ``output\pipeline.h5``. This datastore by default contains
 a copy of each data table after each model step in which the table was modified. The exact fields for each set of outputs will be different for various implementations of ActivitySim.
 
 

develop/_sources/users-guide/model_dev.rst.txt

@@ -57,19 +57,18 @@ Example
 
 To run the estimation example, do the following:
 
-* Activate the correct conda environment if needed
 * Create a local copy of the estimation example folder
 
 ::
 
-  activitysim create -e example_estimation_sf -d test_example_estimation_sf
+  uv run activitysim create -e example_estimation_sf -d test_example_estimation_sf
 
 * Run the example
 
 ::
 
   cd test_example_estimation_sf
-  activitysim run -c configs_estimation/configs -c configs -o output -d data_sf
+  uv run activitysim run -c configs_estimation/configs -c configs -o output -d data_sf
 
 
 * ActivitySim should log some information and write outputs to the output folder, including EDBs for each submodel.  The estimation example runs for about 15 minutes and writes EDBs for 2000 households.
@@ -92,13 +91,11 @@ Additional settings for running ActivitySim in estimation mode are specified in
 Estimation Notebooks
 ~~~~~~~~~~~~~~~~~~~~
 
-ActivitySim includes a `Jupyter Notebook <https://jupyter.org>`__ recipe book with interactive re-estimation examples for each estimatable submodel.  To run a Jupyter notebook, do the following:
+ActivitySim includes a `Jupyter Notebook <https://jupyter.org>`__ recipe book with interactive examples. 
 
-* Open a conda prompt and activate the conda environment with ActivitySim installed
-* If needed, ``conda install jupyterlab`` so you can run jupyter notebooks
-* Type ``jupyter notebook`` to launch the web-based notebook manager
-* Navigate to the ``examples/examples_estimaton/notebooks`` folder and select a notebook from the table below
-* Save the updated coefficient file(s) to the configs folder and run the model in simulation mode
+* To start JupyterLab, from the ActivitySim project directory run ``uv run jupyter lab``. This will start the JupyterLab server and pop up a browser window with the interactive development environment.
+* Navigate to the ``examples/examples_estimaton/notebooks`` folder and select a notebook from the table below.
+* Save the updated coefficient file(s) to the configs folder and run the model in simulation mode.
 
 +-------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
 | Example                             | Notebook                                                                                                                                                                            |