Skip to contents

Prepare data for trip rate model fitting

prepare_trip_adj_model_dt.Rd

Prepares data for trip rate model fitting by merging trips, days, households, persons, and value labels. Use to generate model input for trip rate factor estimation.

Usage

prepare_trip_adj_model_dt(
  trips_types_complete,
  complete_days,
  households,
  persons,
  value_labels
)

Arguments

trips_types_complete

data.table with required columns:

  • day_id — day identifier

  • person_id — person identifier

  • trip_type — trip type label Additional columns as needed for trip diagnostics Rows: one per trip. Modified by reference: no (returns copy).

complete_days

data.table with required columns:

  • day_id — day identifier

  • day_weight — day-level weight Additional columns as needed for day-level diagnostics Rows: one per day. Modified by reference: no (returns copy).

households

data.table. Household-level variables.

persons

data.table. Person-level variables.

value_labels

data.table. Value labels for categorical variables.

Value

data.table. Model input for trip rate factor estimation. Columns include:

  • day_id

  • person_id

  • num_* — trip count columns for each trip type

  • day_weight Additional columns as needed for modeling

Details

  • Counts trips by type and merges with complete days.

  • Adds household and person variables for modeling.

  • Handles missing values and checks consistency.

  • Returns a copy; does not modify by reference.

Settings

None.

See also

  • calc_trip_rate_factor

  • scripts/weighting/trip_rate_factors.R

Other trip rate modeling: calc_trip_rate_factor(), calculate_aggegrate_trip_rates(), extract_trip_rate_factors(), rescale_trip_rate_factors()

Examples

## Not run:
trips_types_complete <- data.table(day_id = 1, person_id = 1, trip_type = "auto")
complete_days <- data.table(day_id = 1, day_weight = 1.2)
households <- data.table()
persons <- data.table()
value_labels <- data.table()
prepare_trip_adj_model_dt(trips_types_complete, complete_days, households, persons, value_labels)
#> Error in .checkTypos(e, names_x): Object 'num_trip_types' not found amongst [day_id, day_weight, num_auto, rowsums]
## End(Not run)