Skip to content

hondabase/d-series

Repository files navigation

D-Series Compression Ratio Calculator

A comprehensive compression ratio calculator for Honda D-series engines with support for multiple units, languages, and advanced features.

Features

Core Functionality

  • Accurate compression ratio calculations using proven formulas
  • Static and effective compression ratio calculations (with elevation and boost)
  • Mean piston speed and maximum piston acceleration calculations
  • Rod/stroke ratio calculations
  • Octane recommendations for both AKI and RON ratings

Advanced Features

  • Multi-language support (English and Portuguese)
  • Unit conversion between metric and imperial
  • Setup link sharing - share your engine configuration via URL
  • Extensive preset database from ZealAutowerks research
  • Head milling and block decking calculations
  • Mobile-responsive design with Tailwind CSS

Data Sources

  • C-Speed Racing compression calculator
  • ZealAutowerks D-series calculator
  • Heeltoe Auto D-series piston specifications
  • D-series engine building notes
  • Complete D-series engine specifications

Installation

Prerequisites

  • Node.js (v16 or higher)
  • pnpm package manager

Setup

  1. Clone the repository:
git clone https://github.com/yourusername/d-series-calculator.git
cd d-series-calculator
  1. Install dependencies:
pnpm install
  1. Run development server:
pnpm dev
  1. Build for production:
pnpm build

Usage

Basic Calculation

  1. Select your engine preset or enter custom values
  2. Choose your head configuration
  3. Select pistons and enter compression height
  4. Specify head gasket thickness
  5. Enter any head milling or block decking
  6. Results update automatically in real-time

Advanced Features

Unit Conversion

Toggle between metric and imperial units using the switch in the header. All values will convert automatically.

Language Selection

Choose between English and Portuguese from the language dropdown. The interface will update immediately.

Setup Links

Click "Copy Setup Link" to generate a shareable URL with all your current settings. Anyone opening this link will see the same configuration.

Effective Compression Ratio

Enter elevation and boost pressure to calculate effective compression ratio accounting for atmospheric conditions.

Technical Details

Formulas Used

Swept Volume

Swept Volume = ((bore/2)² × π × stroke / 1000) × 4 cylinders

Head Gasket Volume

Head Gasket Volume = (((bore - headgasket_difference)/2)² × π × 
                     ((headgasket_thickness - (- piston_to_deck_height)) × 25.4) / 1000) × 4

Compression Ratio

TDC Volume = Swept Volume - Piston Displacement - (- Combustion Chamber Volume) - (- Head Gasket Volume)
BDC Volume = Combustion Chamber Volume - (- Head Gasket Volume) - Piston Displacement

Compression Ratio = TDC Volume / BDC Volume

Mean Piston Speed

Mean Piston Speed = (2 × stroke × RPM) / 60000 (m/s)

Maximum Piston Acceleration

Max Acceleration = ω² × (stroke/2000) × (1 + (1/rod_stroke_ratio))
where ω = (2 × π × RPM) / 60

Supported Engines

D15 Series (1.5L)

  • D15B7, D15Z1, D15B (VTEC)

D16 Series (1.6L)

  • D16A6, D16Y7, D16Z6, D16Y8, D16Y5
  • D16A1, D16A3, DOHC ZC

D17 Series (1.7L)

  • D17A1, D17A2

Supported Pistons

  • PM3/P03 (D15B7) - Flat top
  • P07-010 (D15Z1) - Flat top
  • PM6 (D16A6) - -16.2cc dish
  • P28-A01 (D16Z6) - -3.40cc dish
  • P2P-000 (D16Y8) - -7.4cc dish
  • P2E-000 (D16Y7) - -10.10cc dish
  • P2M-00 (D16Y5) - -7.3cc dish
  • PLM - -6.20cc dish
  • PLR-A0 (D17A2) - 7.2cc dome
  • PDN-A00 (98-00 GX) - Flat top
  • PMS-A00 (01-03 GX) - Flat top
  • P29/PM7 (ZC) - Flat top
  • PG6 (86-87 D16A1) - Flat top
  • P08-010 (JDM 91-99 VTi) - Flat top
  • Vitara - -7.0cc dish

Technology Stack

  • Frontend: Vanilla JavaScript with ES6 modules
  • Styling: Tailwind CSS v4 (built, not CDN)
  • Build Tool: Vite
  • Localization: i18next
  • Package Manager: pnpm

Browser Compatibility

  • Chrome/Edge (latest)
  • Firefox (latest)
  • Safari (latest)
  • Mobile browsers (iOS Safari, Chrome Android)

Contributing

  1. Fork the repository
  2. Create your feature branch (git checkout -b feature/amazing-feature)
  3. Commit your changes (git commit -m 'Add some amazing feature')
  4. Push to the branch (git push origin feature/amazing-feature)
  5. Open a Pull Request

License

This project is licensed under the MIT License - see the LICENSE file for details.

Acknowledgments

  • C-Speed Racing for original compression calculator concepts
  • ZealAutowerks for extensive D-series data
  • Heeltoe Auto for piston specifications
  • Honda community for engine building notes

Disclaimer

This calculator is intended for general estimation only. Certain variables that cannot be accounted for may cause the actual compression ratio to vary, such as a head that has been milled. Always verify measurements with proper tools and consult with experienced engine builders for serious builds.