example_calm needs a little explanation

[activitysim]

example_calm needs a little explanation

[sarahcmap]

Happened to be looking at issues and wanted to see if I could help.

A lot of the field names come from the PUMS data file, which appears to be from 2006-2010. A look at the data dictionary will help out: https://www2.census.gov/programs-surveys/acs/tech_docs/pums/data_dict/PUMS_Data_Dictionary_2006-2010.pdf
You'll see that NP is indeed number of persons.

1. The seed files are at the PUMA geography level, and the population synthesis process is what places each household into a TAZ. After the process is complete, you can see how your synthetic population compares to the controls by looking at the output tables that are specified in the setting.yaml file. The geo_cross_walk.csv is just what tells the program how the different geographies are connected to each other.

2. You refer to the tract level controls on the number of workers. In the controls file, see that the "expression" field for the hh worker controls is households.NWESR, and the statements suggest that this NWESR variable is the number of workers in the household. This appears to be a calculated field based on the ESR variable in the person file.

[bettinardi]

I could also add, as an ODOT employee that provided the "CALM" example. If you look under the "config" folder in the "controls.csv" you will see programmed definitions for relevant fields like the Age and Income categories.

[dkyleward]

Thank you both!