Vehicle Configuration

EVRP supports any electric vehicle through customizable vehicle profiles. This guide explains how to configure vehicles for accurate range and consumption calculations.

Built-in Vehicle Profiles

We maintain profiles for popular EV models. Use the model parameter with a supported vehicle ID:

Model ID	Vehicle	Battery	Range (EPA)
`tesla_model_3_lr`	Tesla Model 3 Long Range	82 kWh	358 mi
`tesla_model_y_lr`	Tesla Model Y Long Range	81 kWh	330 mi
`tesla_model_s_lr`	Tesla Model S Long Range	100 kWh	405 mi
`rivian_r1t`	Rivian R1T	135 kWh	314 mi
`ford_f150_lightning`	Ford F-150 Lightning	131 kWh	320 mi
`chevy_bolt_euv`	Chevrolet Bolt EUV	65 kWh	247 mi

Custom Vehicle Profiles

For vehicles not in our database, provide a custom profile:

{
  "vehicle": {
    "custom_profile": {
      "battery_capacity_kwh": 77,
      "usable_capacity_kwh": 74,
      "consumption_wh_per_km": {
        "city": 140,
        "highway": 180,
        "combined": 160
      },
      "max_charge_rate_kw": 150,
      "charge_curve": [
        { "soc": 0, "rate_kw": 150 },
        { "soc": 50, "rate_kw": 140 },
        { "soc": 80, "rate_kw": 80 },
        { "soc": 90, "rate_kw": 40 }
      ]
    },
    "current_soc_percent": 85
  }
}

Consumption Factors

EVRP adjusts consumption based on real-world conditions:

Speed Impact

Higher speeds increase aerodynamic drag exponentially:

60 mph: Baseline consumption
70 mph: +15% consumption
80 mph: +35% consumption

Climate Adjustment

Battery performance varies with temperature:

{
  "conditions": {
    "ambient_temp_celsius": -5,
    "cabin_heating": true,
    "seat_heating": true
  }
}

Cold weather adjustments:

Below 0°C: +20-30% consumption
Cabin heating: +10-15% additional
Below -10°C: +35-45% consumption

Elevation Changes

Routes with significant elevation gain require more energy:

Uphill: Additional consumption based on gradient
Downhill: Regenerative braking recovery (typically 60-70% efficiency)

Payload and Cargo

For commercial vehicles, account for payload:

{
  "vehicle": {
    "model": "ford_f150_lightning",
    "payload_kg": 500,
    "trailer": {
      "weight_kg": 2000,
      "drag_coefficient": 0.8
    }
  }
}

Best Practices

Use built-in profiles when available - They're calibrated with real-world data
Account for degradation - Older batteries may have 90-95% of original capacity
Include a safety buffer - Set min_arrival_soc_percent to at least 15-20%
Test in conditions - Verify predictions against actual trips

Vehicle Configuration

On this page