@geoarrow/deck.gl-layers (英语)
将大型地理空间数据集用于 甲板.gl (英语),通过 地理箭头。 。 。 .
这只是一个 胶水库 到甲板. gl. (英语). 它产生与上游甲板相同的层对象. gl ,但使用 a 低级二进制接口 表现最好 直接使用二进制接口是很容易搞砸的. 相反,层类暴露于 @geoarrow/deck.gl-layers 专注于使进程易于使用并验证用户输入,并在头罩通关缓冲器下到甲板.gl的二进制接口.

320万点a GeoArrowScatterplotLayer。 。 。 .
特征
- 快点: 直接从一个 箭头联署材料
Table使用 date.gl 二进制数据接口。 。 。 . - 内存效率:没有中间数据表示,也没有垃圾收集机间接费用.
- 全层定制:使用与上游甲板.gl层文档相同的层属性. 任意 访问器 (层属性前缀为:
get*)可以通过箭头Vector。 。 。 . - 输入验证。验证可通过
_validate属性. - 多条形多边形三角形当渲染多边形层时,一个进程叫做 多边形三角形 必须在CPU上实现,然后才能将数据复制到GPU。 通常,这可以阻断主线几秒钟,但
GeoArrowSolidPolygonLayer将在8个网络工作人员中完成这项工作. - 渐进式支持。对于Arrow IPC 和 Parquet 等可流动的数据格式,您可以在数据负载时使每个块的地理箭层成像.
实例
独立实例存在于 examples/ 目录。 如果运行有困难, 请创建一个问题 .
计划在可观察号上提供更多的托管实例.
提供接入者
所有甲板.gl地层具有两种属性: "招标选项" ——常数属性跨一层——和"数据存取器"——可以跨行变化的属性. 访问者是任何前缀属性 get一样 GeoArrowScatterplotLayer是因为 getFillColor。 。 。 .
与 @geoarrow/deck.gl-layers 具体来说,通过这些数据访问器有两种方式,要么作为预计算列,要么在"箭"数据上带有函数回调.
预计算箭头列
如果您有箭头列(Vector 在Arrow JS术语中,您可以直接传递到一层:
import { Table } from "apache-arrow";
import { GeoArrowScatterplotLayer } from "@geoarrow/deck.gl-layers";
const table = new Table(...);
const deckLayer = new GeoArrowScatterplotLayer({
id: "scatterplot",
data: table,
/// Geometry column
getPosition: table.getChild("geometry")!,
/// Column of type FixedSizeList[3] or FixedSizeList[4], with child type Uint8
getFillColor: table.getChild("colors")!,
});
譬如说, 龙板 为所有属性计算 Python 一侧的箭头列,使终端用户具备全部能力 Python. 然后,这些柱子被序列化到Python 以及由此产生的 arrow.Vector 传递到相关层.
函数存取器
GeoArrow 层接受一个带对象的回调 index 财务报告和审定财务报表 data。 。 。 . data 是一个 arrow.RecordBatch 对象(输入的垂直部分) Table),以及 index 是该批中当前行的位置索引。 在 TypeScript 中,您应该看到准确的类型检查.
const deckLayer = new GeoArrowPathLayer({
id: "geoarrow-path",
data: table,
getColor: ({ index, data, target }) => {
const recordBatch = data.data;
const row = recordBatch.get(index)!;
return COLORS_LOOKUP[row["scalerank"]];
},
}),
整个例子在 examples/multilinestring/app.tsx。 。 。 .
您也可以使用指派到 target 如本报告所述,减少垃圾收集器间接费用的道具 deck.gl 性能指南。 。 。 .
数据加载
要使用此库创建 dace. gl 层, 您需要先将 GeoArrow 格式化的数据输入浏览器, 下面讨论 .
OGR/全球司 用于在后端的数据格式中转换,它包括两个 地理箭头 财务报告和审定财务报表 地标 司机们 过 -lco GEOMETRY_ENCODING=GEOARROW 转换为Arrow或Parquet文件,以便将几何存储在地理箭头-内生几何列中.
箭头 IPC
如果您已经拥有了箭头的 IPC 文件( 也叫 Feather 文件) , 并带有地理箭头几何栏, 您可以使用 apache-arrow 要装入这些文件.
import { tableFromIPC } from "apache-arrow";
import { GeoArrowScatterplotLayer } from "@geoarrow/deck.gl-layers";
const resp = await fetch("url/to/file.arrow");
const jsTable = await tableFromIPC(resp);
const deckLayer = new GeoArrowScatterplotLayer({
id: "scatterplot",
data: jsTable,
/// Replace with the correct geometry column name
getPosition: jsTable.getChild("geometry")!,
});
注意这些 IPC 文件必须保存 未压缩 (至少不是内部压缩). 截至v14,Arrow JS目前不支持以内部压缩方式加载IPC文件.
公园
如果您有一个 Parquet 文件, 几何柱被存储为 地理箭头 编码(即不作为带有 WKB 编码的相位元的二进制列),可以使用相位元 parquet-wasm 库可以装入这些文件.
import { readParquet } from "parquet-wasm"
import { tableFromIPC } from "apache-arrow";
import { GeoArrowScatterplotLayer } from "@geoarrow/deck.gl-layers";
const resp = await fetch("url/to/file.parquet");
const arrayBuffer = await resp.arrayBuffer();
const wasmTable = readParquet(new Uint8Array(arrayBuffer));
const jsTable = tableFromIPC(wasmTable.intoIPCStream());
const deckLayer = new GeoArrowScatterplotLayer({
id: "scatterplot",
data: jsTable,
/// Replace with the correct geometry column name
getPosition: jsTable.getChild("geometry")!,
});
下面关于加载 GeoParquet 1.0 文件的说明, 这些文件有 WKB 编码的几何美图, 需要解码后才能使用 @geoarrow/deck.gl-layers。 。 。 .
地标
最初版本 @geoarrow/geoparquet-wasm 库被发布,它读取 GeoParquet 文件到 GeoArrow 内存.
import { readGeoParquet } from "@geoarrow/geoparquet-wasm";
import { tableFromIPC } from "apache-arrow";
import { GeoArrowScatterplotLayer } from "@geoarrow/deck.gl-layers";
const resp = await fetch("url/to/file.parquet");
const arrayBuffer = await resp.arrayBuffer();
const wasmTable = readGeoParquet(new Uint8Array(arrayBuffer));
const jsTable = tableFromIPC(wasmTable.intoTable().intoIPCStream());
const deckLayer = new GeoArrowScatterplotLayer({
id: "scatterplot",
data: jsTable,
/// Replace with the correct geometry column name
getPosition: jsTable.getChild("geometry")!,
});
如果你用它撞到一个错误 @geoarrow/geoparquet-wasm请创建可复制的错误报告 这里。 。 。 .
平面胶纸
最初版本 @geoarrow/flatgeobuf-wasm 库被发布,它将一个 FlatGeobobuf 文件读取到 GeoArrow 内存。 截至0.2.0-β.1版本,此库尚不支持远程文件,并期望完整的FlatGeobuf文件存在于内存中.
import { readFlatGeobuf } from "@geoarrow/flatgeobuf-wasm";
import { tableFromIPC } from "apache-arrow";
import { GeoArrowScatterplotLayer } from "@geoarrow/deck.gl-layers";
const resp = await fetch("url/to/file.fgb");
const arrayBuffer = await resp.arrayBuffer();
const wasmTable = readFlatGeobuf(new Uint8Array(arrayBuffer));
const jsTable = tableFromIPC(wasmTable.intoTable().intoIPCStream());
const deckLayer = new GeoArrowScatterplotLayer({
id: "scatterplot",
data: jsTable,
/// Replace with the correct geometry column name
getPosition: jsTable.getChild("geometry")!,
});
如果你用它撞到一个错误 @geoarrow/flatgeobuf-wasm请创建可复制的错误报告 这里。 。 。 .