From e227d08d85e9ba424e612e3bfaba9dc4132388b8 Mon Sep 17 00:00:00 2001
From: "A.J. de Mooij" <a.j.demooij@gmail.com>
Date: Wed, 1 Dec 2021 18:49:12 +0100
Subject: [PATCH] Added sample of the synthetic population

---
 .gitignore                                    |   1 -
 ...e_activity_assignment_adult_week_1_6_0.csv | 109 ++++++++++++++++++
 ...e_activity_assignment_child_week_1_6_0.csv |  34 ++++++
 ...e_essential_location_designation_1_6_0.csv |   2 +
 ...usa_va_charlottesville_household_1_6_0.csv |   2 +
 ...esville_location_assignment_week_1_6_0.csv |  82 +++++++++++++
 .../usa_va_charlottesville_person_1_6_0.csv   |   4 +
 synthetic-population-instructions.md          |  48 ++++++--
 8 files changed, 274 insertions(+), 8 deletions(-)
 create mode 100755 src/main/resources/charlottesville_examples/usa_va_charlottesville_activity_assignment_adult_week_1_6_0.csv
 create mode 100755 src/main/resources/charlottesville_examples/usa_va_charlottesville_activity_assignment_child_week_1_6_0.csv
 create mode 100755 src/main/resources/charlottesville_examples/usa_va_charlottesville_essential_location_designation_1_6_0.csv
 create mode 100755 src/main/resources/charlottesville_examples/usa_va_charlottesville_household_1_6_0.csv
 create mode 100755 src/main/resources/charlottesville_examples/usa_va_charlottesville_location_assignment_week_1_6_0.csv
 create mode 100755 src/main/resources/charlottesville_examples/usa_va_charlottesville_person_1_6_0.csv

diff --git a/.gitignore b/.gitignore
index f2f3f24..43f6b06 100644
--- a/.gitignore
+++ b/.gitignore
@@ -20,7 +20,6 @@ src/main/resources/va_adult_weekly_activity_sample.csv
 # County data synthetic populations
 src/main/resources/va_examples
 src/main/resources/charlottesville_county_1_9_0
-src/main/resources/charlottesville_examples
 src/main/resources/nelson_county_examples
 src/main/resources/nelson-county-subset/
 src/main/resources/goochland_county_1_9_0
diff --git a/src/main/resources/charlottesville_examples/usa_va_charlottesville_activity_assignment_adult_week_1_6_0.csv b/src/main/resources/charlottesville_examples/usa_va_charlottesville_activity_assignment_adult_week_1_6_0.csv
new file mode 100755
index 0000000..cdf4297
--- /dev/null
+++ b/src/main/resources/charlottesville_examples/usa_va_charlottesville_activity_assignment_adult_week_1_6_0.csv
@@ -0,0 +1,109 @@
+hid,pid,activity_number,activity_type,detailed_activity,start_time,duration,mode,driver_flag,passenger_flag,month,day,survey_id
+2214223,5606501,0,1,1,0,24900,-1,-1,-1,3,1,10524
+2214223,5606501,1,0,0,24900,300,3,1,2,10,2,4298
+2214223,5606501,2,4,13,25200,600,-1,-1,-1,10,2,4298
+2214223,5606501,3,0,0,25800,720,3,1,2,10,2,4298
+2214223,5606501,4,2,3,26520,16080,-1,-1,-1,10,2,4298
+2214223,5606501,5,0,0,42600,600,3,1,2,10,2,4298
+2214223,5606501,6,4,17,43200,1800,-1,-1,-1,10,2,4298
+2214223,5606501,7,0,0,45000,1200,3,1,2,10,2,4298
+2214223,5606501,8,4,13,46200,1200,-1,-1,-1,10,2,4298
+2214223,5606501,9,0,0,47400,300,3,1,2,10,2,4298
+2214223,5606501,10,1,1,47700,53100,-1,-1,-1,10,2,4298
+2214223,5606501,11,1,1,100800,9000,-1,-1,-1,3,4,57178
+2214223,5606501,12,0,0,109800,1800,3,1,2,3,4,57178
+2214223,5606501,13,2,3,111600,43200,-1,-1,-1,3,4,57178
+2214223,5606501,14,0,0,154800,3600,3,1,2,3,4,57178
+2214223,5606501,15,1,1,158400,28800,-1,-1,-1,3,4,57178
+2214223,5606501,16,1,1,187200,9000,-1,-1,-1,3,4,57178
+2214223,5606501,17,0,0,196200,1800,3,1,2,3,4,57178
+2214223,5606501,18,2,3,198000,43200,-1,-1,-1,3,4,57178
+2214223,5606501,19,0,0,241200,3600,3,1,2,3,4,57178
+2214223,5606501,20,1,1,244800,28800,-1,-1,-1,3,4,57178
+2214223,5606501,21,1,1,273600,9000,-1,-1,-1,3,4,57178
+2214223,5606501,22,0,0,282600,1800,3,1,2,3,4,57178
+2214223,5606501,23,2,3,284400,43200,-1,-1,-1,3,4,57178
+2214223,5606501,24,0,0,327600,3600,3,1,2,3,4,57178
+2214223,5606501,25,1,1,331200,28800,-1,-1,-1,3,4,57178
+2214223,5606501,26,1,2,360000,17400,-1,-1,-1,8,6,7022
+2214223,5606501,27,0,0,377400,600,3,1,2,8,6,7022
+2214223,5606501,28,4,6,378000,300,-1,-1,-1,8,6,7022
+2214223,5606501,29,0,0,378300,600,3,1,2,8,6,7022
+2214223,5606501,30,1,2,378900,5700,-1,-1,-1,8,6,7022
+2214223,5606501,31,0,0,384600,600,3,1,2,8,6,7022
+2214223,5606501,32,4,6,385200,600,-1,-1,-1,8,6,7022
+2214223,5606501,33,0,0,385800,600,3,1,2,8,6,7022
+2214223,5606501,34,4,6,386400,600,-1,-1,-1,8,6,7022
+2214223,5606501,35,0,0,387000,1500,3,1,2,8,6,7022
+2214223,5606501,36,4,16,388500,5700,-1,-1,-1,8,6,7022
+2214223,5606501,37,0,0,394200,900,3,1,2,8,6,7022
+2214223,5606501,38,1,2,395100,11700,-1,-1,-1,8,6,7022
+2214223,5606501,39,0,0,406800,600,3,1,2,8,6,7022
+2214223,5606501,40,4,6,407400,1200,-1,-1,-1,8,6,7022
+2214223,5606501,41,0,0,408600,1800,3,1,2,8,6,7022
+2214223,5606501,42,3,11,410400,2700,-1,-1,-1,8,6,7022
+2214223,5606501,43,0,0,413100,1200,3,1,2,8,6,7022
+2214223,5606501,44,1,1,414300,32100,-1,-1,-1,8,6,7022
+2214223,5606501,45,1,1,446400,25500,-1,-1,-1,8,7,370
+2214223,5606501,46,0,0,471900,2100,3,1,2,8,7,370
+2214223,5606501,47,3,11,474000,1500,-1,-1,-1,8,7,370
+2214223,5606501,48,0,0,475500,300,3,1,2,8,7,370
+2214223,5606501,49,4,13,475800,3000,-1,-1,-1,8,7,370
+2214223,5606501,50,0,0,478800,2100,3,1,2,8,7,370
+2214223,5606501,51,1,1,480900,600,-1,-1,-1,8,7,370
+2214223,5606501,52,0,0,481500,600,3,1,2,8,7,370
+2214223,5606501,53,3,11,482100,2100,-1,-1,-1,8,7,370
+2214223,5606501,54,0,0,484200,300,3,1,2,8,7,370
+2214223,5606501,55,1,1,484500,48300,-1,-1,-1,8,7,370
+2214223,5606501,56,1,1,532800,72000,-1,-1,-1,3,1,10524
+2214223,5606502,0,1,1,0,48900,-1,-1,-1,3,1,10524
+2214223,5606502,1,0,0,48900,900,4,1,2,10,2,4299
+2214223,5606502,2,2,3,49800,29700,-1,-1,-1,10,2,4299
+2214223,5606502,3,0,0,79500,900,4,1,2,10,2,4299
+2214223,5606502,4,1,1,80400,20400,-1,-1,-1,10,2,4299
+2214223,5606502,5,1,1,100800,10800,-1,-1,-1,3,4,57177
+2214223,5606502,6,0,0,111600,1800,4,1,2,3,4,57177
+2214223,5606502,7,2,3,113400,30600,-1,-1,-1,3,4,57177
+2214223,5606502,8,0,0,144000,1800,4,1,2,3,4,57177
+2214223,5606502,9,1,1,145800,41400,-1,-1,-1,3,4,57177
+2214223,5606502,10,1,1,187200,10800,-1,-1,-1,3,4,57177
+2214223,5606502,11,0,0,198000,1800,4,1,2,3,4,57177
+2214223,5606502,12,2,3,199800,30600,-1,-1,-1,3,4,57177
+2214223,5606502,13,0,0,230400,1800,4,1,2,3,4,57177
+2214223,5606502,14,1,1,232200,41400,-1,-1,-1,3,4,57177
+2214223,5606502,15,1,1,273600,10800,-1,-1,-1,3,4,57177
+2214223,5606502,16,0,0,284400,1800,4,1,2,3,4,57177
+2214223,5606502,17,2,3,286200,30600,-1,-1,-1,3,4,57177
+2214223,5606502,18,0,0,316800,1800,4,1,2,3,4,57177
+2214223,5606502,19,1,1,318600,41400,-1,-1,-1,3,4,57177
+2214223,5606502,20,1,2,360000,17400,-1,-1,-1,8,6,7022
+2214223,5606502,21,0,0,377400,600,3,1,2,8,6,7022
+2214223,5606502,22,4,6,378000,300,-1,-1,-1,8,6,7022
+2214223,5606502,23,0,0,378300,600,3,1,2,8,6,7022
+2214223,5606502,24,1,2,378900,5700,-1,-1,-1,8,6,7022
+2214223,5606502,25,0,0,384600,600,3,1,2,8,6,7022
+2214223,5606502,26,4,6,385200,600,-1,-1,-1,8,6,7022
+2214223,5606502,27,0,0,385800,600,3,1,2,8,6,7022
+2214223,5606502,28,4,6,386400,600,-1,-1,-1,8,6,7022
+2214223,5606502,29,0,0,387000,1500,3,1,2,8,6,7022
+2214223,5606502,30,4,16,388500,5700,-1,-1,-1,8,6,7022
+2214223,5606502,31,0,0,394200,900,3,1,2,8,6,7022
+2214223,5606502,32,1,2,395100,11700,-1,-1,-1,8,6,7022
+2214223,5606502,33,0,0,406800,600,3,1,2,8,6,7022
+2214223,5606502,34,4,6,407400,1200,-1,-1,-1,8,6,7022
+2214223,5606502,35,0,0,408600,1800,3,1,2,8,6,7022
+2214223,5606502,36,3,11,410400,2700,-1,-1,-1,8,6,7022
+2214223,5606502,37,0,0,413100,1200,3,1,2,8,6,7022
+2214223,5606502,38,1,1,414300,32100,-1,-1,-1,8,6,7022
+2214223,5606502,39,1,1,446400,25500,-1,-1,-1,8,7,370
+2214223,5606502,40,0,0,471900,2100,3,1,2,8,7,370
+2214223,5606502,41,3,11,474000,1500,-1,-1,-1,8,7,370
+2214223,5606502,42,0,0,475500,300,3,1,2,8,7,370
+2214223,5606502,43,4,13,475800,3000,-1,-1,-1,8,7,370
+2214223,5606502,44,0,0,478800,2100,3,1,2,8,7,370
+2214223,5606502,45,1,1,480900,600,-1,-1,-1,8,7,370
+2214223,5606502,46,0,0,481500,600,3,1,2,8,7,370
+2214223,5606502,47,3,11,482100,2100,-1,-1,-1,8,7,370
+2214223,5606502,48,0,0,484200,300,3,1,2,8,7,370
+2214223,5606502,49,1,1,484500,48300,-1,-1,-1,8,7,370
+2214223,5606502,50,1,1,532800,72000,-1,-1,-1,3,1,10524
diff --git a/src/main/resources/charlottesville_examples/usa_va_charlottesville_activity_assignment_child_week_1_6_0.csv b/src/main/resources/charlottesville_examples/usa_va_charlottesville_activity_assignment_child_week_1_6_0.csv
new file mode 100755
index 0000000..c411831
--- /dev/null
+++ b/src/main/resources/charlottesville_examples/usa_va_charlottesville_activity_assignment_child_week_1_6_0.csv
@@ -0,0 +1,34 @@
+hid,pid,activity_number,activity_type,detailed_activity,start_time,duration,mode,driver_flag,passenger_flag,month,day,survey_id
+2214223,5606503,0,1,1,0,29700,-1,-1,-1,12,1,2123
+2214223,5606503,1,0,0,29700,420,2,2,1,2,2,3164
+2214223,5606503,2,5,24,30120,31980,-1,-1,-1,2,2,3164
+2214223,5606503,3,0,0,62100,300,2,2,1,2,2,3164
+2214223,5606503,4,1,1,62400,38400,-1,-1,-1,2,2,3164
+2214223,5606503,5,1,1,100800,86400,-1,-1,-1,3,3,9281
+2214223,5606503,6,1,1,187200,86400,-1,-1,-1,3,3,9281
+2214223,5606503,7,1,1,273600,86400,-1,-1,-1,3,3,9281
+2214223,5606503,8,1,1,360000,15600,-1,-1,-1,5,6,3193
+2214223,5606503,9,0,0,375600,120,1,2,1,5,6,3193
+2214223,5606503,10,4,72,375720,300,-1,-1,-1,5,6,3193
+2214223,5606503,11,0,0,376020,120,1,2,1,5,6,3193
+2214223,5606503,12,5,24,376140,29760,-1,-1,-1,5,6,3193
+2214223,5606503,13,0,0,405900,840,1,2,1,5,6,3193
+2214223,5606503,14,3,41,406740,4560,-1,-1,-1,5,6,3193
+2214223,5606503,15,0,0,411300,180,1,2,1,5,6,3193
+2214223,5606503,16,4,82,411480,2520,-1,-1,-1,5,6,3193
+2214223,5606503,17,0,0,414000,780,1,2,1,5,6,3193
+2214223,5606503,18,1,1,414780,31620,-1,-1,-1,5,6,3193
+2214223,5606503,19,1,1,446400,23520,-1,-1,-1,3,7,2290
+2214223,5606503,20,0,0,469920,600,3,2,1,3,7,2290
+2214223,5606503,21,3,40,470520,4500,-1,-1,-1,3,7,2290
+2214223,5606503,22,0,0,475020,780,3,2,1,3,7,2290
+2214223,5606503,23,1,1,475800,57000,-1,-1,-1,3,7,2290
+2214223,5606503,24,1,1,532800,25800,-1,-1,-1,12,1,2123
+2214223,5606503,25,0,0,558600,600,1,2,1,12,1,2123
+2214223,5606503,26,3,41,559200,600,-1,-1,-1,12,1,2123
+2214223,5606503,27,0,0,559800,300,1,2,1,12,1,2123
+2214223,5606503,28,3,41,560100,900,-1,-1,-1,12,1,2123
+2214223,5606503,29,0,0,561000,300,1,2,1,12,1,2123
+2214223,5606503,30,3,41,561300,600,-1,-1,-1,12,1,2123
+2214223,5606503,31,0,0,561900,300,1,2,1,12,1,2123
+2214223,5606503,32,1,1,562200,42600,-1,-1,-1,12,1,2123
diff --git a/src/main/resources/charlottesville_examples/usa_va_charlottesville_essential_location_designation_1_6_0.csv b/src/main/resources/charlottesville_examples/usa_va_charlottesville_essential_location_designation_1_6_0.csv
new file mode 100755
index 0000000..2ca7768
--- /dev/null
+++ b/src/main/resources/charlottesville_examples/usa_va_charlottesville_essential_location_designation_1_6_0.csv
@@ -0,0 +1,2 @@
+lid,designation,isResidential
+1704173,,1
diff --git a/src/main/resources/charlottesville_examples/usa_va_charlottesville_household_1_6_0.csv b/src/main/resources/charlottesville_examples/usa_va_charlottesville_household_1_6_0.csv
new file mode 100755
index 0000000..0db20fb
--- /dev/null
+++ b/src/main/resources/charlottesville_examples/usa_va_charlottesville_household_1_6_0.csv
@@ -0,0 +1,2 @@
+admin1,admin2,admin3,admin4,hid,serialno,puma,record_type,hh_unit_wt,hh_size,vehicles,hh_income,units_in_structure,business,heating_fuel,household_language,family_type_and_employment_status,workers_in_family,rlid,residence_longitude,residence_latitude
+51,540,201,1,2214223,2015000952034,51090,H,30,3,2,171000,3,2,3,1,1,2,1704173,-78.481543,38.043668
diff --git a/src/main/resources/charlottesville_examples/usa_va_charlottesville_location_assignment_week_1_6_0.csv b/src/main/resources/charlottesville_examples/usa_va_charlottesville_location_assignment_week_1_6_0.csv
new file mode 100755
index 0000000..369241f
--- /dev/null
+++ b/src/main/resources/charlottesville_examples/usa_va_charlottesville_location_assignment_week_1_6_0.csv
@@ -0,0 +1,82 @@
+hid,pid,activity_number,activity_type,start_time,duration,lid,longitude,latitude,travel_mode
+2214223,5606501,0,1,0,24900,1704173,-78.481543000000,38.043668000000,-1
+2214223,5606501,2,4,25200,600,100780,-78.484510000000,38.036050000000,-1
+2214223,5606501,4,2,26520,16080,125100,-78.505060000000,38.050250000000,-1
+2214223,5606501,6,4,43200,1800,135070,-78.482900000000,38.033340000000,-1
+2214223,5606501,8,4,46200,1200,130369,-78.500590000000,38.031040000000,-1
+2214223,5606501,10,1,47700,53100,1704173,-78.481543000000,38.043668000000,-1
+2214223,5606501,11,1,100800,9000,1704173,-78.481543000000,38.043668000000,-1
+2214223,5606501,13,2,111600,43200,125100,-78.505060000000,38.050250000000,-1
+2214223,5606501,15,1,158400,28800,1704173,-78.481543000000,38.043668000000,-1
+2214223,5606501,16,1,187200,9000,1704173,-78.481543000000,38.043668000000,-1
+2214223,5606501,18,2,198000,43200,125100,-78.505060000000,38.050250000000,-1
+2214223,5606501,20,1,244800,28800,1704173,-78.481543000000,38.043668000000,-1
+2214223,5606501,21,1,273600,9000,1704173,-78.481543000000,38.043668000000,-1
+2214223,5606501,23,2,284400,43200,125100,-78.505060000000,38.050250000000,-1
+2214223,5606501,25,1,331200,28800,1704173,-78.481543000000,38.043668000000,-1
+2214223,5606501,26,1,360000,17400,1704173,-78.481543000000,38.043668000000,-1
+2214223,5606501,28,4,378000,300,125022,-78.497110000000,38.031270000000,-1
+2214223,5606501,30,1,378900,5700,1704173,-78.481543000000,38.043668000000,-1
+2214223,5606501,32,4,385200,600,133613,-78.497110000000,38.031270000000,-1
+2214223,5606501,34,4,386400,600,85494,-78.499840000000,38.032570000000,-1
+2214223,5606501,36,4,388500,5700,100780,-78.484510000000,38.036050000000,-1
+2214223,5606501,38,1,395100,11700,1704173,-78.481543000000,38.043668000000,-1
+2214223,5606501,40,4,407400,1200,91203,-78.502460000000,38.030710000000,-1
+2214223,5606501,42,3,410400,2700,35941,-78.490040000000,38.031530000000,-1
+2214223,5606501,44,1,414300,32100,1704173,-78.481543000000,38.043668000000,-1
+2214223,5606501,45,1,446400,25500,1704173,-78.481543000000,38.043668000000,-1
+2214223,5606501,47,3,474000,1500,70629,-78.479950000000,38.040410000000,-1
+2214223,5606501,49,4,475800,3000,127361,-78.498650000000,38.039860000000,-1
+2214223,5606501,51,1,480900,600,1704173,-78.481543000000,38.043668000000,-1
+2214223,5606501,53,3,482100,2100,451,-78.502030000000,38.051980000000,-1
+2214223,5606501,55,1,484500,48300,1704173,-78.481543000000,38.043668000000,-1
+2214223,5606501,56,1,532800,72000,1704173,-78.481543000000,38.043668000000,-1
+2214223,5606502,0,1,0,48900,1704173,-78.481543000000,38.043668000000,-1
+2214223,5606502,2,2,49800,29700,112970,-78.014220000000,38.459310000000,-1
+2214223,5606502,4,1,80400,20400,1704173,-78.481543000000,38.043668000000,-1
+2214223,5606502,5,1,100800,10800,1704173,-78.481543000000,38.043668000000,-1
+2214223,5606502,7,2,113400,30600,112970,-78.014220000000,38.459310000000,-1
+2214223,5606502,9,1,145800,41400,1704173,-78.481543000000,38.043668000000,-1
+2214223,5606502,10,1,187200,10800,1704173,-78.481543000000,38.043668000000,-1
+2214223,5606502,12,2,199800,30600,112970,-78.014220000000,38.459310000000,-1
+2214223,5606502,14,1,232200,41400,1704173,-78.481543000000,38.043668000000,-1
+2214223,5606502,15,1,273600,10800,1704173,-78.481543000000,38.043668000000,-1
+2214223,5606502,17,2,286200,30600,112970,-78.014220000000,38.459310000000,-1
+2214223,5606502,19,1,318600,41400,1704173,-78.481543000000,38.043668000000,-1
+2214223,5606502,20,1,360000,17400,1704173,-78.481543000000,38.043668000000,-1
+2214223,5606502,22,4,378000,300,127698,-78.495980000000,38.032850000000,-1
+2214223,5606502,24,1,378900,5700,1704173,-78.481543000000,38.043668000000,-1
+2214223,5606502,26,4,385200,600,134340,-78.479320000000,38.055380000000,-1
+2214223,5606502,28,4,386400,600,135099,-78.501960000000,38.032090000000,-1
+2214223,5606502,30,4,388500,5700,106142,-78.014590000000,38.459690000000,-1
+2214223,5606502,32,1,395100,11700,1704173,-78.481543000000,38.043668000000,-1
+2214223,5606502,34,4,407400,1200,105075,-78.462870000000,38.021820000000,-1
+2214223,5606502,36,3,410400,2700,36256,-78.478830000000,38.029920000000,-1
+2214223,5606502,38,1,414300,32100,1704173,-78.481543000000,38.043668000000,-1
+2214223,5606502,39,1,446400,25500,1704173,-78.481543000000,38.043668000000,-1
+2214223,5606502,41,3,474000,1500,38554,-78.468710000000,38.026910000000,-1
+2214223,5606502,43,4,475800,3000,94986,-78.471220000000,38.030130000000,-1
+2214223,5606502,45,1,480900,600,1704173,-78.481543000000,38.043668000000,-1
+2214223,5606502,47,3,482100,2100,32232,-78.490860000000,38.038190000000,-1
+2214223,5606502,49,1,484500,48300,1704173,-78.481543000000,38.043668000000,-1
+2214223,5606502,50,1,532800,72000,1704173,-78.481543000000,38.043668000000,-1
+2214223,5606503,0,1,0,29700,1704173,-78.481543000000,38.043668000000,-1
+2214223,5606503,2,5,30120,31980,77885,-78.496329000000,38.038462000000,-1
+2214223,5606503,4,1,62400,38400,1704173,-78.481543000000,38.043668000000,-1
+2214223,5606503,5,1,100800,86400,1704173,-78.481543000000,38.043668000000,-1
+2214223,5606503,6,1,187200,86400,1704173,-78.481543000000,38.043668000000,-1
+2214223,5606503,7,1,273600,86400,1704173,-78.481543000000,38.043668000000,-1
+2214223,5606503,8,1,360000,15600,1704173,-78.481543000000,38.043668000000,-1
+2214223,5606503,10,4,375720,300,111288,-78.478310000000,38.032090000000,-1
+2214223,5606503,12,5,376140,29760,77885,-78.496329000000,38.038462000000,-1
+2214223,5606503,14,3,406740,4560,2882,-78.502920000000,38.051260000000,-1
+2214223,5606503,16,4,411480,2520,135293,-78.478640000000,38.031600000000,-1
+2214223,5606503,18,1,414780,31620,1704173,-78.481543000000,38.043668000000,-1
+2214223,5606503,19,1,446400,23520,1704173,-78.481543000000,38.043668000000,-1
+2214223,5606503,21,3,470520,4500,74332,-78.504730000000,38.050560000000,-1
+2214223,5606503,23,1,475800,57000,1704173,-78.481543000000,38.043668000000,-1
+2214223,5606503,24,1,532800,25800,1704173,-78.481543000000,38.043668000000,-1
+2214223,5606503,26,3,559200,600,10908,-78.484940000000,38.031890000000,-1
+2214223,5606503,28,3,560100,900,17248,-78.475820000000,38.025260000000,-1
+2214223,5606503,30,3,561300,600,34393,-78.500160000000,38.054160000000,-1
+2214223,5606503,32,1,562200,42600,1704173,-78.481543000000,38.043668000000,-1
diff --git a/src/main/resources/charlottesville_examples/usa_va_charlottesville_person_1_6_0.csv b/src/main/resources/charlottesville_examples/usa_va_charlottesville_person_1_6_0.csv
new file mode 100755
index 0000000..e8ab276
--- /dev/null
+++ b/src/main/resources/charlottesville_examples/usa_va_charlottesville_person_1_6_0.csv
@@ -0,0 +1,4 @@
+hid,pid,serialno,person_number,record_type,age,relationship,sex,school_enrollment,grade_level_attending,employment_status,employment_socp,cell_id,designation
+2214223,5606503,2015000952034,3,P,3,2,1,1,,,,,none
+2214223,5606501,2015000952034,1,P,34,0,1,1,,1,119XXX,,none
+2214223,5606502,2015000952034,2,P,33,1,2,1,,1,399011,,none
diff --git a/synthetic-population-instructions.md b/synthetic-population-instructions.md
index e77b95c..e95a377 100644
--- a/synthetic-population-instructions.md
+++ b/synthetic-population-instructions.md
@@ -5,6 +5,11 @@ but we have not been granted the right to redistribute these files.
 In this manual we detail the specifications of the synthetic population
 required to instantiate our simulation, so that you may be able to produce or convert your own.
 
+We have also taken a sample from the synthetic population representing the details and activities of 3 agents
+(2 adults and one child) from a single household. These files can be found in 
+[src/main/resources/charlottesville_example](src/main/resources/charlottesville_examples)
+and can serve as extra illustration of this documentation.
+
 ## Why we use a synthetic population
 Agents in our simulation are drawn from a synthetic
 population of the state of Virginia, USA. This synthetic population has been constructed from multiple
@@ -72,9 +77,10 @@ In the [sample configuration](src/main/resources/config.toml) with which the sim
 we refer to the synthetic population for the county of Charlottesville City.
 
 Not all values in the synthetic population used for this research are actually employed in the simulation. 
-However, they are all parsed by the model, so their presence is required. 
+However, some are still parsed by the model, so their presence is required. 
 The unused values are below marked with an asterisk, and can be given arbitrary values (within their type constraints) 
-without having an effect on the simulation. 
+without having an effect on the simulation, while the values from the synthetic population (present in the sample
+files) are not documented here at all.
 Do note that this repository contains ongoing research, and these values may be used in later versions.
 
 In the following, categorical types are distinguished in that they are linked to a 
@@ -82,7 +88,7 @@ Java ENUM where the possible value types are also documented.
 
 ### Person files
 In the sample config, one Person file for Charlottesville City is specified: 
-`charlottesville_examples/usa_va_charlottesville_person_1_6_0.csv`
+[`charlottesville_examples/usa_va_charlottesville_person_1_6_0.csv`](src/main/resources/charlottesville_examples/usa_va_charlottesville_person_1_6_0.csv)
 
 Each of the person files is parsed using the [`PersonReader`](src/main/java/nl/uu/iss/ga/model/reader/PersonReader.java) 
 and each person record is instantiated in the [`Person`](src/main/java/nl/uu/iss/ga/model/data/Person.java) class.
@@ -125,7 +131,8 @@ Possible designations are {`military`, `government`, `retail`, `none`, `educatio
 `care_facilitation`, `dmv`}, where `none` and a null value are equivalent
 
 ### Household files
-In the sample config, one Household file for Charlottesville City is specified: `charlottesville_examples/usa_va_charlottesville_household_1_6_0.csv`
+In the sample config, one Household file for Charlottesville City is specified: 
+[`charlottesville_examples/usa_va_charlottesville_household_1_6_0.csv`](src/main/resources/charlottesville_examples/usa_va_charlottesville_household_1_6_0.csv)
 
 Each of the household files is parsed using the [`HouseholdReader`](src/main/java/nl/uu/iss/ga/model/reader/HouseholdReader.java)
 and each household record is instantiated in the [`Household`](src/main/java/nl/uu/iss/ga/model/data/Household.java) class.
@@ -175,8 +182,8 @@ The semantics of the values can be found in the
 
 ### Activity files
 In the sample config, two Activity files for Charlottesville City are specified, one for adult agents, and one for children:
-* `charlottesville_examples/usa_va_charlottesville_activity_assignment_adult_week_1_6_0.csv`
-* `charlottesville_examples/usa_va_charlottesville_activity_assignment_child_week_1_6_0.csv`
+* [`charlottesville_examples/usa_va_charlottesville_activity_assignment_adult_week_1_6_0.csv`](src/main/resources/charlottesville_examples/usa_va_charlottesville_activity_assignment_adult_week_1_6_0.csv)
+* [`charlottesville_examples/usa_va_charlottesville_activity_assignment_child_week_1_6_0.csv`](src/main/resources/charlottesville_examples/usa_va_charlottesville_activity_assignment_child_week_1_6_0.csv)
 
 The activity files encode the activities over the course of one week for each agent in the population.
 
@@ -206,4 +213,31 @@ for more information.
 * [`start_time`](src/main/java/nl/uu/iss/ga/model/data/ActivityTime.java): 
 A long value representing a time stamp for when the activity starts as the number of seconds since monday morning
 (so `0` represents the first second of a Monday, and `24 * 60 * 60 = 86400` represents the first second of Tuesday).
-* `duration`: The number of seconds an activity continues
\ No newline at end of file
+* `duration`: The number of seconds an activity continues
+* `lid`<sup>♰</sup>: A long-typed value representing the unique ID of the location to be visited. Multiple visits of this
+or other agents to the same location should have the same ID
+* `longitude`<sup>♰</sup>: The longitude of the activity location.
+  **IMPORTANT**: This value is used to calculate the radius of gyration, so should be sampled accurately
+* `latitude`<sup>♰</sup>: The latitude of the activity location.
+  **IMPORTANT**: This value is used to calculate the radius of gyration, so should be sampled accurately
+* [`travel_mode*`](src/main/java/nl/uu/iss/ga/model/data/dictionary/TransportMode.java)<sup>♰</sup>:
+  A categorical integer in the range [-9,-7] ∪ [1,20] ∪ {97} representing the mode of transport employed during a
+  `TRIP` type activity (no value required for other activity types)
+  The semantics of the values can be found in the
+  [`TransportMode*`](src/main/java/nl/uu/iss/ga/model/data/dictionary/TransportMode.java) enum.
+
+
+### An optional class of files: Location assignment
+The location designation of activities can be split to a separate class of files, as long as for each activity number
+generated in the activity files, 
+there is a location assigned in one of the location designation files.
+This is the case in the provided samples, but it is not necessary, as all the relevant information used by the 
+simulation can be specified as above.
+
+In the sample config, one location assignment file is specified:
+[`charlottesville_examples/usa_va_charlottesville_location_assignment_week_1_6_0.csv`](src/main/resources/charlottesville_examples/usa_va_charlottesville_location_assignment_week_1_6_0.csv)
+
+Each record encodes the location for exactly one activity that is specified in the activity files.
+If this approach is taken, the fields marked with a cross (<sup>♰</sup>) can be *moved* to this class of files
+(i.e. deleted from the activity files), while the fields `hid`, `pid`, `activity_number`, `activity_type`, 
+`start_time`, and `duration` should be replicated, with the exact same values for matching records.
\ No newline at end of file