geotiff.js 技术文档

geotiff.js 技术文档

geotiff.js geotiff.js is a small library to parse TIFF files for visualization or analysis. It is written in pure JavaScript, and is usable in both the browser and node.js applications. 项目地址: https://gitcode.com/gh_mirrors/ge/geotiff.js

安装指南

使用npm安装

您可以通过npm轻松地安装geotiff.js到您的项目中：

npm install geotiff

或者，如果您想在网页中直接使用，可以利用CDN服务：

<script src="https://cdn.jsdelivr.net/npm/geotiff"></script>

这样做将使GeoTIFF对象全局可用。

项目使用说明

geotiff.js允许您从各种来源读取（地理）TIFF文件中的元数据和原始数组数据。以下是一些基本步骤来开始使用这个库：

加载GeoTIFF文件

您可以使用不同的方法加载数据，例如通过URL、ArrayBuffer或本地文件（Blob或File）。

// 从URL加载
const tiff = await fromUrl('path/to/tiff/file.tif');

// 从ArrayBuffer加载
const response = await fetch('path/to/tiff/file.tif');
const arrayBuffer = await response.arrayBuffer();
const tiffFromArrayBuffer = await fromArrayBuffer(arrayBuffer);

// 从本地选择的文件加载
document.querySelector('#file-input').addEventListener('change', async (event) => {
    const file = event.target.files[0];
    const tiffFromFile = await fromBlob(file);
});

获取图像并访问元数据

一旦加载了TIFF文件，您可以获取其包含的第一张图像，并访问其元数据。

const image = await tiff.getImage();
const width = image.getWidth();
const height = image.getHeight();

读取栅格数据

为了处理实际的像素数据，需要调用readRasters方法。可以选择是否需要交织数据。

const data = await image.readRasters({ interleave: true }); // 或者false，取决于需求

API使用文档

geotiff.js提供了丰富的方法来操作GeoTIFF数据，如getWidth(), getHeight(), getOrigin(), getResolution(), 和 getBoundingBox()等，用于获取图像的基本信息。对于高级应用，readRasters()是至关重要的，它接受可选参数以定制数据的读取方式。

示例：提取特定坐标下的高程值

async function getElevationAtCoordinates(tiff, lat, lon) {
    const image = await tiff.getImage();
    const { ModelPixelScale, ModelTiepoint } = image.fileDirectory;
    // 计算像素坐标
    // 注意：这里简化了转换过程，具体转换可能更复杂
    // 实际应用中应详细计算地理坐标到像素坐标的转换
    
    // 假设正确实现了地理坐标到像素坐标的转换逻辑后，读取像素值
    const rasters = await image.readRasters();
    const elevation = rasters[0][/* 计算得到的y轴像素位置 */ * /* 计算得到的x轴像素位置 */];
    
    return elevation;
}

项目构建与测试

若要为项目做贡献或运行测试，首先克隆仓库并安装依赖项：

git clone https://github.com/geotiffjs/geotiff.js.git
cd geotiff.js/
npm install

确保您的系统已经安装了GDAL和ImageMagick，这主要用于设置测试数据。之后，通过以下命令执行测试：

npm test

开发过程中，可以通过npm run dev启动一个本地服务器进行实时测试。

总结

geotiff.js提供了一个强大的平台，使得在JavaScript环境中处理复杂的地理标记的TIFF数据变得简单。通过灵活的读取策略和详细的元数据访问，开发者能够高效地集成地理空间数据分析到web应用之中。遵循上述指南，您将能够充分利用此库的强大功能。

geotiff.js geotiff.js is a small library to parse TIFF files for visualization or analysis. It is written in pure JavaScript, and is usable in both the browser and node.js applications. 项目地址: https://gitcode.com/gh_mirrors/ge/geotiff.js