thrustcurve-db

thrustcurve-db

ThrustCurve.org model rocket motor data as a single data structure, (plus misc utility functions).

This module is rebundling of the rocket motor data available on John Coker's exceptional thrustcurve.org website ("TC"). Specifically, it is a JSON file produced by doing the following:

• Fetch data for all motors from the ThrustCurve API
• Fetch all available thrust sample files for each motor. Picks the best ("best") file and normalizes to a consistent format. (Basically just insuring it starts with a [0, 0] sample)
• Normalize the delays value to numeric values and ranges, or "P"lugged.

License & Support

• Please read and understand the ThrustCurve.org license
• This is a snapshot of the TC data. It may be out of date. File an issue here if you think it needs to be updated.
• Issues with how motor data is translated into JSON should be filed as an issue here.
• Issues with incorrect motor data should be directed to the TC site.

Installation

You know the drill ...

npm i thrustcurve-db

Usage

import MOTORS, {parseDelays, unparseDelays} from 'thrustcurve-db';

// `MOTORS` is a Motor[] array.

for (const motor of MOTORS) {
  // See `thrustcurve-db.d.ts` for Motor structure details.
  console.log(motor); // Spew data for ~1,100 motors to console
}

// parseDelays() parses a motor `delays` value to determine the
// delay options. The returned Object has the following properties:
//
//    times: Number[] array of possible delay times (seconds)
//  plugged: true if motor has a "Plugged" configuration
//
// Aerotech delays (S, M, L, X) are transformed as follows:
// S -> 0-6
// M -> 0-10
// L -> 0-14
// X -> 0-18
//
// Note: `times` are guaranteed to be unique and in ascending order.
// E.g.  `parseDelays('L, S')` and `parseDelays('1, 5, M, L')` will
// produce the same result.

parseDelays('S, 16, P'); // -> {
                         //   times: [0,1,2,3,4,5,6,16],
                         //   plugged: true
                         // }

// unparseDelays(parsed) is the inverse operation of parseDelays() (sort of).

unparseDelays({
  times: [0,1,2,3,4,5,6,16],
  plugged: true
}); // -> "0-6,16,P"