uddf2js

Parse UDDF XML dive logs to JavaScript objects with unit conversion.

Features

• Parses UDDF (Universal Dive Data Format) XML files
• Converts units to SI, metric, or imperial
• Always returns arrays for dives and waypoints
• Robust against missing sections

Installation

npm install uddf2js

Usage

const { parseUDDF } = require('uddf2js');
const fs = require('fs');

const xmlData = fs.readFileSync('mydive.uddf', 'utf8');
parseUDDF(xmlData, 'metric').then(result => {
  console.log(result.unit); // 'metric'
  const waypoints = result.data.uddf.profiledata.repetitiongroup[0].dive[0].samples.waypoint;
  console.log(waypoints);
});

Unit Options

• 'si' (default): SI units (Kelvin, m^3, meters, bar)
• 'metric': Celsius, liters, meters, bar
  • seconds are not converted to minutes
• 'imperial': Fahrenheit, cubic feet, feet, PSI
  • seconds are converted to minutes, but if it's between 1 and 59 seconds, it will be a string like '0:ss'

API

parseUDDF(xmlData, unit)

• xmlData: String containing UDDF XML
• unit: 'si', 'metric', or 'imperial' (optional)
• Returns: Promise resolving to { unit, data }

License

MIT