Getting Started¶
This page describes how to install and run PopulationSim with the provided example.
Installation¶
1. It is recommended that you install and use a conda package manager for your system. One easy way to do so is by using Anaconda 64bit Python 3, although you should consult the terms of service for this product and ensure you qualify (as of summer 2021, businesses and governments with over 200 employees do not qualify for free usage). If you prefer a completely free open source conda tool, you can download and install the appropriate version of Miniforge.
If you access the internet from behind a firewall, then you will need to configure your proxy server. To do so, create a .condarc file in your Anaconda installation folder (i.e.
C:\ProgramData\Anaconda3
), such as:
proxy_servers:
http: http://myproxy.org:8080
https: https://myproxy.org:8080
ssl_verify: false
Create and activate an Anaconda environment (basically a Python install just for this project)
conda create -n popsim python=3.8
# Windows
activate popsim
# Mac
conda activate popsim
Get and install the PopulationSim package on the activated conda Python environment:
# best to use the conda version of pytables for consistency with activitysim
conda install pytables
pip install populationsim
ActivitySim¶
Note
PopulationSim is a 64bit Python 3 library that uses a number of packages from the scientific Python ecosystem, most notably pandas and numpy. It also relies heavily on the ActivitySim package.
The recommended way to get your own scientific Python installation is to install 64 bit Anaconda, which contains many of the libraries upon which ActivitySim depends + some handy Python installation management tools.
For more information on Anaconda and ActivitySim, see ActivitySim’s getting started guide.
Run Examples¶
There are four examples for running PopulationSim, three created using data from the Corvallis-Albany-Lebanon Modeling (CALM) region in Oregon and the other using data from the Metro Vancouver region in British Columbia.
The example_calm set-up runs PopulationSim, where a synthetic population is created single-processed for the entire modeling region.
The example_calm_mp set-up runs PopulationSim multi-processed, where a synthetic population is created for the entire modeling region by simultaneously balancing results using multiple processors on your computer, thereby reducing runtime.
The example_calm_repop set-up runs PopulationSim in the repop mode, which updates the synthetic population for a small part of the region.
The example_survey_weighting set-up runs PopulationSim for the case of developing final weights for a household travel survey. More information on the configuration of PopulationSim can be found in the Application & Configuration section.
Example_calm¶
Follow the steps below to run example_calm set up:
Open a command prompt in the example_calm folder
Run the following commands:
activate popsim python run_populationsim.py
Review the outputs in the output folder
Example_calm_mp¶
Follow the steps below to run example_calm_mp multiprocessed set up:
Open a command prompt in the example_calm folder
In
configs_mp\setting.yaml
, setnum_processes: 2
to a reasonable number of processors for your machineRun the following commands:
activate popsim python run_populationsim.py -c configs_mp -c configs
Review the outputs in the output folder
Example_calm_repop¶
The repop configuration requires outputs from a base run. Therefore, the base configuration must be run before running the repop configuration. Follow the steps below to run example_calm_repop set up:
Copy the pipeline.h5 file from the example_calm\output directory to example_calm_repop\output directory (all PopulationSim files are stored in pipeline.h5 file)
Open a command prompt in the example_calm_repop folder
Run the following commands:
activate popsim python run_populationsim.py
Review the outputs in the output folder
Example_survey_weighting¶
Follow the steps below to run example_survey_weighting set up:
Open a command prompt in the example_survey_weighting folder
Run the following commands:
activate popsim python run_populationsim.py
Review the outputs in the output folder