were
are
were
are
steps
step
likelihood to be a confounder in the relationship
recommend rephrasing
verifies
verify
TipIn development
While commendable to show that RSG has improvements planned, I wonder if we are setting ourselves up to deliver more work beyond project contract if we set this expectation?
Browser and Call Center
be consistent in how platforms are referenced. See previous note
The adjustment procedure operated at the linked trip level. Each linked trip was classified into a mutually exclusive trip type, and trip rate factors were then estimated and applied to linked trips. Unlinked trips and tours received their weights from linked trips.
Review for tense. This is all past tense, while previous chapters were mostly present
Error
note multiple errors listed in this chapter
day trip class
add a descriptor
Error in eval
Is this supposed to be an error?
rMove data
Is a key/definition of rMove data=app data explained?
four
three? There are only 3 categories listed
GLMs
what are GLMs?
9
typo?
trip
can these uniformly be referred to as "unlinked trips"?
applied
applies
that
with
distributions
ditto
adjustment
Perhaps add an interpretation example, and suggested next steps, based on the figure below?
household
"household- "
.csv
bold
match
matches
PopulationSim?
I think this explanation should be moved up in this manual, since PopSim is referenced multiple times before this chapter.
, the
should there be an "and" added after the comma?
m: number of mailed invites in the sample segment H: total number of households in the sample segment (estimated from 5-year ACS data) R: number of responses (complete households) in the sample segment BW: base weight for a given sample segment
Suggest turning this into bulleted list
this
capitalize first letter
optionally
remove
optionally
remove. It's not necessary
pivots the data to wide format
is this a common phrase? If not can it be restated or eliminated?
assigned
assigns
assigned
assigns
is
remove
reassignment
add a hyphen here, or remove the hyphen in the subheader for consistency
(See: Fahimi et al. 2024)[https://publichealth.jmir.org/2024/1/e48186/]
should the URL be inside the parentheses?
~10%
I have seen this referenced as 20% in other places. Let's get a consensus on the %
(NPS)are
add a space
Household
Remove italics in subheader for consistency
adjust_unrelated_pums
Is this in the script or manual? If the former, I suggest also referencing the part in Ch 8 (Survey Data Preparation) or simply that there's more detail to come in Ch 8. Without more context it leaves users asking why it's on longer used, or why there was legacy code in the first place
review to ensure the updates
Is there guidance for this review?
file
I was expecting a PSRC specifics box to follow, given previous "Optional" paragraph treatments
labelled
Suggest changing to "labeled," as the other version is British English spelling
e.g.
missing a comma
checksum
Is this is a variable or part of the script? If so, the font type should match how other variables or script are handled for consistency (and user recognition)
household
"household-"
The
This is minor but should this be step #5? Then the list of 9.1-9.5 nicely aligns with the numbered steps here
First, the script counts the number of adults and children in each household to retain household composition information. Next, it re-labels the number of vehicles to maintain consistency. The key transformation then assigns each adult as their own household by modifying the SERIALNO and SPORDER identifiers, effectively creating a new household for each adult while dropping children from the dataset. This ensures that person-level targets are accurately represented, with each adult treated as a separate entity for weighting purposes. Finally, the script verifies that the total weights remain consistent after this restructuring, ensuring that the overall population estimates are preserved.
Consider reformatting this into a bulleted list
For Person-Level Studies – Adjust Households to Persons
Remove italics to be consistent with other sub headers
were
Change to "are" for consistent present tense
Group quarters residents
"Residents of group quarters," since the examples cite group quarters, not residents
Optional: Adjust for unrelated household members.
Should this have additional guidance?
households so that estimates align with the population
I suggest rephrasing, something like: "data so that estimates align with the targets (i.e.,population)."
referebce
typo
Gray
This may be splitting hairs. Outside the study region is listed as "gray" here but in the figure & legend, it appears more purple. Maybe because it's the rainbow colors which make me assume the last color is purple (or violet), and also because there are other regions in the map that are gray, albeit a lighter shade of gray
(a)
Can this be displayed within the paragraph and not in this separate text box? It's odd to have to scroll horizontally to finish reading this paragraph
dropped to keep the table tidy
Recommend rewording
This
I appreciate these types of helpful tips!
TRUE
I find having interspersed code like this in narrative descriptions sometimes hard to follow since I don't know what "largest_bg_to_client_zone" is meant to be. Would a reader/user of this manual be familiar with this code already?
zones
some funky formatting going on here
bigint
Is this a commonly known term? I wasn't familiar with it so I looked it up
stop here
maybe "run validation here"? Otherwise it's unclear what "stop" this references
QA
write out
Figure 2.1
Include a reference & description of the figure to give it context
un
recommend "non" over "un"
R
Add "Python" as well, since in 2.3 Python is listed, along with R and Quarto