runalyze/dem-reader

Read digital elevation files such as GeoTIFF files for srtm data or similar.

1.2.0 2021-10-18 13:37 UTC

Requires

• php: >=8.0

Requires (Dev)

• friendsofphp/php-cs-fixer: ^3.2
• phpunit/phpunit: ^9.0

MIT

README

Library to read digital elevation models, such as GeoTIFF files for SRTM. The GeoTIFF reader itself is originally based on Bob Osola's SRTMGeoTIFFReader.

Usage

use Runalyze\DEM\Reader;
use Runalyze\DEM\Provider\GeoTIFF\SRTM4Provider;

$Provider = new SRTM4Provider('path/to/srtm/files');
$Reader = new Reader($Provider);
$elevations = $Reader->getElevations($latitudes, $longitudes);

To give you some more details: Each provider is valid for its own. You can just ignore the general reader and use your favorite provider:

use Runalyze\DEM\Provider\GeoTIFF\SRTM4Provider;

$Provider = new SRTM4Provider('path/to/srtm/files');
$elevations = $Provider->getElevations($latitudes, $longitudes);

But you may have more than one provider available or different paths where your dem files are located. You can attach as many providers as you want to the reader. Each of them will be checked if it can handle the given elevation data (in the order they were attached) and the wirst one that does will be used.

use Runalyze\DEM\Reader;
use Runalyze\DEM\Provider\GeoTIFF\SRTM4Provider;

$Reader = new Reader();
$Reader->addProvider(new SRTM4Provider('path/to/europe/srtm/files'));
$Reader->addProvider(new SRTM4Provider('path/to/america/srtm/files'));

$europeElevations = $Reader->getElevations($europeLatitudes, $europeLongitudes);
$americaElevations = $Reader->getElevations($americaLatitudes, $americaLongitudes);

License

Code released under the MIT license.