Domicile Activity analysis

Domicile Activity is a type of stop analysis used to observe a commercial vehicle's duty cycle. This analysis looks at the driving activity between when a vehicle leaves and returns to the location where it stops the longest.

Running a Domicile Activity analysis

Learn how to run a Domicile Activity analysis, including selecting zones, adjusting filters, and viewing the results.

From the main menu, select Stop Analytics. The Analysis Area panel displays.
Click + Select zones.
Either Search for a region or choose from the Country options.
Select a Province or State.
1. If you choose a State, you must choose a County before selecting a City.
  Note:
  When a ZIP falls outside a City, but falls within a County the option for Outside City Limits displays. Only purchased datasets display as options. Click the information icon to view how to purchase unavailable geographies.
Click Continue.
Select Domicile Activity as the Stop Behavior.
Select the Zone type to analyze (County, City, ZIP, TAZ, or Census Tract).
Adjust the Domicile Activity Filters by clicking on the Edit button. Update your filters, then click Done.
Click Run Domicile Analysis. A popup message displays the estimated loading time to validate your analysis. After validating the analysis, the screen displays information about the next steps and what to expect in terms of time until you can see the results.
Toggle Email me when complete to ON to receive an email with a link to open your analysis even if you leave the page.
Once the analysis is complete, you see the map with your outlined type of aggregation in the center of the screen. The summary of your analysis is displayed at the bottom of your screen in the Overview table.

Domicile Activity filters

Understand the various filters and settings available in the Domicile Activity analysis, including date range selection, vehicle classification, vocation analysis, industry designation, fuel types, and vehicle eligibility comparison. It also details the definition and customization options for duty cycles.

Date range

Allows you to select up to four date ranges for one stop analysis. The stop analysis will only take into account stops that started and ended within these dates. The ability to select multiple date ranges allows you to cover patterns over a broad time without having to analyze all the data.

Vehicle class

Allows you to select the vehicle's classification type. The vehicle's VIN is used to determine the Gross Vehicle Weight Rating (GVWR). The GVWR is then used to assess its vehicle classification. Refer to the Data Dictionary for more information on the specific quantifiers of each vehicle class.

Vocation

Geotab has a patented machine learning algorithm which is used to determine the purpose or job (vocations) of the vehicles from which we collect data. You can select multiple vocations for an analysis. Refer to the Data Dictionary for details.

Industry

Whenever available, Geotab has assigned a primary industry designation to the vehicles contributing to the analytics. These classifications are based on NAICS primary industry code. Refer to the Data Dictionary for information on NAICS codes and their corresponding industries.

Fuel Types

Indicates the fuel type of the vehicle, determined from the VIN.

Vehicle eligibility comparison

Compare eligible vehicles against all vehicles in the dataset by toggling Comparison on.

Minimum duty cycles from domicile: Choose the minimum number of times a vehicle must leave its domicile and return to end its duty cycle. Calculated based on the entire analysis period.
Maximum travel distance of duty cycles: The maximum distance a vehicle can travel within a duty cycle to still be considered eligible.
Required percentile of cycles under limit: Adjust the percentile of a vehicle’s duty cycle travel limit to meet eligibility criteria.

Duty cycle definition

By default, after a vehicle returns to their domicile, the first stop event within the location area is counted as the end of a duty cycle. To choose this scenario, toggle Stop back at domicile.

Alternatively, toggle Custom stop duration to ignore short stops back to the domicile and defining how long a stop has to be to count as the end of a duty cycle.

Duty cycle trip distance

Set a minimum duty cycle travel distance.

Percentiles to surface

Configure the percentiles of distribution for stop duration, idle duration, before and after trip duration, before and after trip distance.

Reviewing Domicile Activity results

After running a Domicile Activity analysis, you can view, select, filter, and compare vehicles. You can also interpret various metrics and Expansion Factors across different tabs and views.

To view results after running a Domicile Activity analysis:

Select Display view to filter the results. You can do the following on the Display view dropdown:

Choose between All vehicles (excluding filtered) and Eligible vehicles. Eligible vehicles have filtering analysis based on the filters selected for the analysis.
You can toggle Compare to eligible on to view a comparison of all and eligible vehicles.
View All vehicles or Eligible vehicles only on the map when comparing.

You analysis results will be displayed on the Overview, Zones List, Location Trends or Expansion tabs.

Overview

The Overview tab displays the metrics selected based off of Filters and Zone type selected.

Domiciling Activity metrics

Domicile Stop Events (Total): Count of stopping events at domiciles that occur after vehicles return from a duty cycle.
Vehicles Stopping (Total): The number of unique vehicles contributing to the count of Domicile Stop Events.
Domicile Stop Duration (Med): The amount of time vehicles stay at their domicile location after stopping, before leaving again.

Duty Cycle Activity metrics

Cycle Travel Distance (Med): The distance vehicles drive after leaving their domicile, before returning.
Cycle Stop Duration (Med): The amount of time vehicles stay at each stop before resuming driving, while away from the domicile.
Cycle Duration (Med): The amount of time vehicles spend away from their domicile before returning.
Cycle Stop Events (Med): The amount of stopping events while away from the domicile, before returning, excluding the domicile stop.

Top Zones by selected metric

Select a metric to view the zones that mostly contribute to it.

The Measurements section outlines the Median, Average, and Standard Duration for each Metric. For more information about what each metric is, hover over the desired metric and a tooltip displays, or visit the Altitude Data Dictionary.

Vehicle attributes

The following graphs indicate the filters chosen. If no filters are selected for the following vehicle attributes, then all data is returned.

The vehicle attributes that display in this section are the following:

Vehicle class: Allows you to select the vehicle's classification type. The vehicle's VIN is used to determine the Gross Vehicle Weight Rating (GVWR). The GVWR is then used to assess its vehicle classification.
Vocation: Geotab has a patented machine learning algorithm which is used to determine the purpose or job (vocations) of the vehicles from which we collect data. You can select multiple vocations for an analysis.
Industry: Displays a pie chart that represents the percentage of stops by industry as defined by the primary NAICS code.
Fuel Types: Displays a pie chart that represents the percentage of stops in your analysis that uses the specific fuel types if selected.

Select the Pie Chart or Bar Graph icons to switch between layouts.

Zones list

Under the Zones List tab, a table displays the following for each Zone:

Domicile Stop Events
Vehicles Stopping
Domicile Stop Duration
Cycle Travel Distance
Cycle Duration
Cycle Stop Events
Cycle Stop Duration
Note:
Domicile Stop Duration, Cycle Travel Distance, Cycle Duration, Cycle Stop Events, and Cycle Stop Duration columns can be adjusted to display the Average, Median, Standard Deviation, and Percentiles by opening the dropdown menu.

Exploring Zones on the map

Learn how to explore specific Zones on the map after conducting a Domicile Activity analysis, including viewing details, metrics trends, and adjusting map legends for better data visualization.

After running a Domicile Activity analysis, you can expand the map to view your results.

From the Zones List tab, select a Zone to zoom into its specific location on the Map. The selected location is highlighted on the table. A data card displays the metrics overview towards the right of the Map.
1. Click View details or double-click a stop location to get to the Details tab, which includes similar information as the Overview tab, but caters specifically to the zone you selected, instead of an overview for all zones within your analysis.
2. Open the Time trends tab to view metrics trends over time. Select a metric from the Choose metrics to display dropdown to filter the graphs. Scroll down to Domicile Activity or Duty Cycle Activity sections to view a breakdown of each activity specific to the zone type within your analysis dataset.
Adjust the Map Legend to switch the data displayed on the Map between Domicile Stop Events, Domiciling Vehicles, Domicile Stop Duration, Cycle Travel Distance, Cycle Duration, Cycle Stop Events, and Cycle Stop Duration.
- Enable the Time toggle on the Map Legend to analyze metrics for a particular hour of the day, day of the week, or month within the date range selected. Enable the Accentuate toggle to better distinguish between the gradient colors on the Map.
- Hover over the legend range or drag the handle to reveal a tooltip with the corresponding value.
- Click and drag the handle to adjust the legend range, or double-click the legend range to reset the minimum and maximum to the original position.

Reviewing Location Trends

The Location Trends tab provides several graphs to analyze vehicle activity, domicile stops, and cycle data. You can customize the view of each graph using various metrics, sorting options, and graph types.

The Location Trends tab includes the following graphs:

Activity Distribution: Activity distribution of all time within each zone compared to other zones.
Domicile Stop Events: Count of stopping events at domiciles that occur after vehicles return from a duty cycle.
Domiciling Vehicles: The number of unique vehicles contributing to the count of Domicile Stop Events.
Domicile Stop Duration: The amount of time vehicles stay at their domicile location after stopping, before leaving again.
Cycle Travel Distance: The distance vehicles drive after leaving their domicile, before returning.
Cycle Duration: The amount of time vehicles spend away from their domicile before returning. Includes both driving and stopped time throughout the duty cycle.
Cycle Stop Events: Count of stopping events while away from the domicile, before returning. This does not include the domicile stop.
Cycle Stop Duration: The amount of time vehicles stay at each stop before resuming driving while away from the domicile.

Each Graph allows you to choose viewing options on the toolbar. The options vary depending on the graph.

Metric: View information by Median, Average, Standard deviation, Percentiles.
Sorting: Sort based on zone names, duration, count of events, distance.
Graph type: Select between bar chart or table view.

Expansion Factors

The Expansion Factors tab displays reference locations to help you estimate ground-truth counts from Altitude counts.

By default, the map shows your purchased datasets. From the table filters, you can select the Specificity of expansion: State or Counties.

State and county level Expansion Factors are derived using a weighted average across road segments within each state or county. Aggregations are grouped based on road types and vehicle groups. View the Expansion Factors: Technical White Paper v3.0 for more information.

State: When you select State, the table displays information for all states included in your purchased datasets. Select a state from the map or the table to view details. States with limited data have a warning pill, as the expansion for them is done by referencing expansion factors from adjacent states.
Counties: For Counties, you must select each state you want to view from the dropdown menu. Toggle States with purchased datasets only to OFF to view all states. Click any county from the list after selecting a state to open a side window that provides expansion insights. Click View state for state details.

Note:
Expansion Factors are only available in the USA.

Viewing Expansion Factors on the map

View the Reference Locations from the Expansion Factors table on the map. Each letter on the map corresponds to the letter and location from the table.

To view the expansion factors on the map:

Navigate to Datasets > Expansion Factors from the main menu.
Select a County or click an Expansion Factor on the map.
- Below Specificity of expansion (USA only):, select Counties. Select a County from the list.
- Click an Expansion Factor on the map.
  Note:
  Once you click on a row in the table or an expansion factor on the map, the state details window automatically updates.

View a hover card that outlines the ID, Heavy Duty Vehicles Expansion Factors, and Confidence Interval (CI) 95% insights.

Expansion Factors table

View county expansion factors to help you estimate ground-truth counts from Altitude counts. This table is not filtered by input filters, as the ground-truth reference data is structured differently. For more information about Expansion factors, visit Expansion Factors 3.1.


Header	Description
Road Type	Displays the type of road the reference location is counting vehicles on.
Expansion Factor (Universal)	Displays multipliers that can be used to scale counts reported in Altitude to estimated ground-truths.
CI 95% (Universal)	Displays the Confidence Interval (CI) for an expansion factor with a 95% confidence level.
Expansion Factor (Medium-duty vehicles)	Displays the expansion factor for commercial medium-duty vehicles. Note: This category is not part of Altitude filters outside of Expansion.
CI 95% (Medium-duty vehicles)	Displays the CI for commercial medium-duty vehicles.
Expansion Factor (Heavy-duty vehicles)	Displays the expansion factor for commercial heavy-duty vehicles. Note: This category is not part of Altitude filters outside of Expansion.
CI 95% (Heavy-duty vehicles)	Displays the CI for commercial heavy-duty vehicles. Note: This category is not part of Altitude filters outside of Expansion.

Viewing state details

View state details and access state expansion insights.

To view state details:

Navigate to Datasets > Expansion Factors from the main menu.

State details window

View state factors to help you estimate ground-truth counts from Altitude counts. The state details window displays the following:


Header	Description
Counties	Displays all counties within the selected State for analysis.
Reference Year	Select between 2023 or 2022 data.
Filter	Ability to filter the state details for Vehicle class and Road type.
ID	Identification number assigned to the counties.
Expansion Factor	Displays multipliers that can be used to scale counts reported in Altitude to estimated ground-truths.
CI 95%	Displays the Confidence Interval (CI) for an expansion factor with a 95% confidence level.
Marketshare est.	The estimated percent of market share Altitude has at the geography compared to ground-truth data.
Expansion factor (Medium-duty Vehicles)	Expansion factor for activity occurring with commercial medium-duty vehicles.
Expansion factor (Heavy-duty Vehicles)	Expansion factor for activity occurring with commercial heavy-duty vehicles.
Statistical Fit	Level of fit Fit of Altitude movement insights to ground-truth reference data at the specific reference location. This is based on R-squared. To learn more about this insight, see Expansion Factors 3.1 . Error measures (MAPE) Mean Absolute Percentage Error (MAPE) is the measurement of the error between counts calculated using the expansion factor and the actual ground-truth.
Location details	Parent geography Displays the Reference Location County.
Ground-truth reference data	A dataset that is referenced against in Altitude to create expansion factor multipliers. For more information about this insight, see Expansion Factors 3.1.

Stop Events analysis

Regional Domicile Analytics concepts