README

A modular GPX parser written in PHP, designed to analyze GPS tracks and enhance elevation data using the IGN (Institut national de l'information géographique et forestière) API.

Features

• Parse GPX files (tracks, segments, points)
• Calculate statistics (distance, elevation gain/loss, speed, time)
• Smooth elevation data with Savitzky-Golay filter
• Correct elevation using the official IGN elevation API
• Modular architecture (separate reader, writer, calculators)
• PSR-4 autoloading (compatible with modern PHP projects)

Installation

composer require inspyrenees/phpgpxparser

Requirements

• PHP 8.1+
• Symfony HTTP Client
• Geotools Library

Basic Usage

use PhpGpxParser\PhpGpxParser;

$phpGpxParser = new PhpGpxParser();
$stats = $phpGpxParser
    ->read($this->gpxFilePath)
    ->smoothElevation() // Optional: apply Savitzky-Golay smoothing
    ->stats();

echo "Total Distance: " . $stats->getTotalDistance() . " m";
echo "Elevation Gain: " . $stats->getElevationGain() . " m";
echo "Average Speed: " . $stats->getAvgSpeed() . " km/h";

You can apply a Savitzky-Golay filter to smooth elevation data and reduce GPS noise using the smoothElevation() method before computing statistics.

🔗 Dependencies

• Symfony HTTP Client for robust network operations
• Geotools for precise geographical calculations

License

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