TECHNICAL DOCUMENTATION v2.0

PHYSICS-BASED SIMULATION

Real-world vehicle dynamics powered by accurate physics calculations, gear ratio databases, environmental modeling, and advanced tuning system

01 Project Overview

The Hypercar Performance Simulator is a web-based platform that accurately models the acceleration and top speed performance of extreme hypercars using physics-based calculations. Version 2.0 features 30+ vehicles and an advanced tuning system.

Unlike simplified racing games, this simulator accounts for real-world factors including aerodynamic drag, rolling resistance, torque curves, transmission losses, environmental conditions, and hybrid/electric powertrains. Every calculation is grounded in physics principles and validated against real-world performance data.

Version
2.0.0
Vehicles
30+ Hypercars
Backend
FastAPI + Python
Frontend
Vanilla JavaScript
Database
CSV-Based
Timestep
0.01s (100Hz)

02 Physics Engine

Force Calculations

Fnet = Fdrive - Fdrag - Froll
  • Drive Force: Wheel torque ÷ tire radius
  • Drag Force: 0.5 × ρ × Cd × A × v²
  • Rolling Resistance: Crr × m × g

Gear Selection

RPM = (v × 60 × ratio) ÷ (2π × r)
  • Shift Strategy: Database-driven shift points
  • Validation: Minimum RPM check (50% redline)
  • Optimization: Maintains optimal powerband

Environmental Effects

ρ = P ÷ (R × T)
  • Air Density: Temperature & altitude dependent
  • Pressure Adjustment: Barometric formula
  • Performance Impact: Affects drag & power

Torque Modeling

Twheel = Tengine × ratio × η
  • Torque Curve: 10-point interpolation
  • Hybrid System: Electric motor contribution
  • Efficiency: Transmission losses included

03 Race Modes

🏁

Quarter Mile

Classic 402.336m drag race

🚀

Half Mile

804.672m high-speed challenge

One Mile

1,609.344m ultimate test

📏

Custom Distance

Set any distance you want

🔄

Lap Race

Multiple laps on circuit

⏱️

Acceleration Zone

0-100, 100-200, custom ranges

💨

Roll Race

60-200 km/h flying start

🔥

Top Speed

Maximum velocity run

04 Vehicle Fleet (30+)

Koenigsegg

  • Jesko Absolut
  • Jesko Attack
  • Regera (Hybrid)
  • Agera RS

Bugatti

  • Chiron Super Sport 300+
  • Bolide
  • Veyron Super Sport

McLaren

  • Speedtail (Hybrid)
  • P1 (Hybrid)
  • Senna
  • 765LT
  • 720S

Ferrari

  • SF90 Stradale (Hybrid)
  • LaFerrari (Hybrid)
  • F8 Tributo
  • 812 Superfast

Lamborghini

  • Revuelto (Hybrid)
  • Aventador SVJ
  • Sian FKP 37 (Hybrid)
  • Huracan STO

Electric Hypercars

  • Rimac Nevera
  • Lotus Evija
  • Aspark Owl
  • Pininfarina Battista

Porsche

  • 918 Spyder (Hybrid)
  • 911 GT2 RS
  • 911 Turbo S

Others

  • Mercedes-AMG ONE (Hybrid)
  • Gordon Murray T.50
  • Czinger 21C (Hybrid)
  • Aston Martin Valkyrie (Hybrid)
  • Pagani Huayra R
  • SSC Tuatara
  • And more...

05 Advanced Tuning System

Engine Tuning

  • Stock: Factory specifications
  • Stage 1: +15% power, +12% torque
  • Stage 2: +30% power, +25% torque
  • Stage 3: +50% power, +40% torque

Tire Compounds

  • Street: Standard grip
  • Sport: +15% grip, -5% rolling resistance
  • Slick: +35% grip, -10% rolling resistance

Aerodynamics

  • Stock: Factory aero package
  • Sport: -5% drag, +20% downforce
  • Race: -12% drag, +50% downforce

Weight Reduction

  • Stock: Factory weight
  • Lightweight: -5% mass
  • Race: -12% mass

Transmission

  • Stock: Factory efficiency
  • Sport: +5% efficiency
  • Race: +10% efficiency

Boost & NOS

  • Boost Pressure: 0.5x to 2.0x multiplier
  • Nitrous Oxide: +25% power, +20% torque

06 Technical Stack

Backend

  • FastAPI — High-performance Python web framework
  • Pydantic — Data validation and serialization
  • Uvicorn — ASGI server for production
  • CSV Database — Simple, editable data storage

Frontend

  • Vanilla JavaScript — No framework dependencies
  • Canvas API — Real-time race visualization
  • CSS Animations — Smooth UI transitions
  • Responsive Design — Mobile-friendly layout

Physics Engine

  • Euler Integration — Timestep-based simulation
  • Torque Interpolation — Realistic power curves
  • Gear Management — CSV-driven shift logic
  • Environmental Modeling — Air density calculations
  • Hybrid/EV Systems — Electric motor contribution

API Endpoints

  • GET /api/vehicles — List available hypercars
  • POST /api/simulate/drag — Run simulation
  • POST /api/reload — Reload CSV database
  • GET /api/health — System status check

07 Setup & Usage

1

Install Dependencies

pip install fastapi uvicorn pydantic
2

Place CSV Database

hypercar_data.csv
3

Start Server

uvicorn app.main:app --reload --port 8000
4

Access Simulator

http://localhost:8000/index.html

Ready to Experience Hypercar Performance?

Launch the simulator and witness physics-accurate acceleration modeling with 30+ vehicles

START SIMULATOR