Skip to content
Closed
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 1 addition & 3 deletions ROADMAP.md
Original file line number Diff line number Diff line change
Expand Up @@ -285,9 +285,7 @@ attributes kept.
- A scene with a free camera and each layer's elevation mode (on the ground, relative, absolute),
Phase 2 of [#726](https://github.com/opengeos/RustGIS/issues/726), after the Z design above.
- LiDAR point layers (LAS/LAZ/COPC, read today as points) drawn at their heights in the scene.
- Terrain from several layers ([#1310](https://github.com/opengeos/RustGIS/issues/1310)), and
finer terrain once a tilted view settles
([#1523](https://github.com/opengeos/RustGIS/issues/1523)).
- Terrain from several layers ([#1310](https://github.com/opengeos/RustGIS/issues/1310)).
- 3D objects and 3D Tiles follow.

## Exploratory
Expand Down
6 changes: 4 additions & 2 deletions apps/rustgis-python/python/rustgis/__init__.py
Original file line number Diff line number Diff line change
Expand Up @@ -369,7 +369,8 @@ def _outputs(self, result: Any) -> Any:

A file of several layers (the tables of a GeoPackage, a GDAL file split by geometry
type) reports the first as ``"layer"`` and every one as ``"layers"``, so ``"layers"``
decides. Standalone tables added with the layers are in :meth:`info`, not returned.
decides. Any standalone tables that were actually added are in :meth:`info`, not
returned. GeoPackage attribute-only tables are not imported when adding a whole file.

Args:
result: The command's result.
Expand Down Expand Up @@ -561,7 +562,8 @@ def add_data(self, path: PathLike, name: Optional[str] = None, **params: Any) ->
path: The file: GeoJSON, CSV, Shapefile (or a zip of them), GeoPackage, GeoParquet,
FlatGeobuf, KML/KMZ, GPX, GeoTIFF, ASCII grid, and the formats GDAL or DuckDB
read when they are installed.
name: The layer's name (the file's name when left out).
name: The layer's name (the file's name when left out). For a file adding several
layers, this names only the first layer added.
**params: More ``layer.addData`` parameters, e.g. ``layer=`` for one table of a
GeoPackage, ``x=`` and ``y=`` for a CSV's coordinate columns.

Expand Down
16 changes: 9 additions & 7 deletions docs/user-guide/analysis.md
Original file line number Diff line number Diff line change
Expand Up @@ -686,8 +686,9 @@ layers**: the prediction, named by `output`, and `<output>_variance`.
the count of output polygon features whose total area is less than one millionth (`1e-6`) of
their input feature's area, measured in the overlay plane. These may be slivers along the clip
boundary; they are kept unchanged. Check these features before using the result as a map series
index, where a tiny sliver can make an apparently empty page. Ordinary clipped pieces give no
sliver notice, and empty intersections are still left out.
index, where a tiny sliver can make an apparently empty page. A genuine small piece of a very
large input can also trigger this notice. Pieces at or above the ratio give no sliver notice,
and empty intersections are still left out.

**Erase** (`erase`) removes from `input` features (points, lines or polygons) their parts inside
the `erase` polygons. An erase polygon's edge counts as inside it, as for Clip, so a point on the
Expand Down Expand Up @@ -948,9 +949,9 @@ digits, so `06/23/2021` converts but `6/23/2021` doesn't).
A date such as `2026-03-05` becomes `2026-03`, keeping different years separate.
2. Run **Summary Statistics** on the permits, with **Case Fields** = `issue_month` and a
**COUNT** statistic on `issue_date` (use **Add statistic**).
3. Read `FREQUENCY` as the number of permits per month. Records without a date form a separate
group with an empty key. The output
contains months present in the data; it does not fill in missing months with zero.
3. Read `FREQUENCY` as the number of permits per month. A null date and an empty-text date form
separate groups with null and empty-text keys; if both forms occur, there are two groups. The
output contains months present in the data; it does not fill in missing months with zero.

**Minimum Bounding Geometry** (`convexHull`) encloses each feature in its convex hull (Group
Option `None`), or all of them in one (`All`, with `count`, the features it enclosed). It passes
Expand Down Expand Up @@ -1742,8 +1743,9 @@ The Imagery tab's groups open their tools in the Workflows pane. The tab belongs
`nearest` and `mode`; other methods remove them with a notice naming the affected bands.
Palette images use `nearest` for sampling and `mode` for aggregation, keeping their classes.
- Cells off the raster are its no-data value. A raster without one keeps its bands as they are,
with NaN there in a floating-point type and 0 in a whole-number one, as GDAL leaves them; a
colour image gains an alpha band instead, so they are see-through.
with NaN there in a floating-point type and 0 in an unlabelled whole-number one. If any band
has class names, every band uses NaN outside, keeping class zero distinct from missing
coverage. A colour image gains an alpha band instead, so outside cells are see-through.
- Datums are shifted as everywhere in RustGIS, through each system's transformation to WGS 84
(a Helmert step for SAD69 or Córrego Alegre, a few metres from the IBGE's grid shifts).
- The result has to fit in memory (120 million values, cells times bands, or more on a computer
Expand Down
6 changes: 3 additions & 3 deletions docs/user-guide/data-formats.md

Large diffs are not rendered by default.

41 changes: 26 additions & 15 deletions docs/user-guide/data.md
Original file line number Diff line number Diff line change
Expand Up @@ -54,10 +54,17 @@ first and its points last, so its points are drawn on top, and a KML's ground ov
them. A name given goes to the first map layer added, the bottom one (a standalone table only gets
it when the file has no map layer). A GeoPackage adds its tables in name order, and a file read
through GDAL keeps its layers in the file's order and orders only the types within each layer.
GeoPackage attribute-only tables are not supported. Adding a whole file reports their count in
one notice. Tile and other unsupported GeoPackage contents are also counted by type. The omission counts cover catalog entries without a registered geometry column; unknown content types are combined into one counted "other" group. Only contents registered in `gpkg_contents` are considered; arbitrary unregistered SQLite tables are ignored. Desktop uploads add their first feature table, with the existing note naming how many feature tables the file contains. Browser uploads with virtual generated `table_name` or `data_type` catalog columns cannot be evaluated and are refused with an explanation; materialize these columns or select a feature table explicitly. A file
containing only attribute tables is refused with the count. Selecting a
feature table explicitly adds only that table.
GeoPackage attribute-only tables are not supported. Adding a whole file reports their count in one
notice. Tile and other unsupported GeoPackage contents are also counted by type. The omission counts
cover catalog entries without a registered geometry column; unknown content types are combined into
one counted "other" group. Only contents registered in `gpkg_contents` are considered; arbitrary
unregistered SQLite tables are ignored. Desktop uploads add their first feature table, with the
existing note naming how many feature tables the file contains. Browser uploads with virtual
generated `table_name` or `data_type` catalog columns cannot be evaluated and are refused with an
explanation; materialize these columns or select a feature table explicitly. A file containing only
attribute or tile tables is refused with the count. Selecting a feature table explicitly adds only
that table.

On the desktop, **Home › Add › Add Data › Add Folder…** connects a folder to the Browser; the web
app does not offer folder connections.
On the desktop, a file Add Data reads whole (a GeoTIFF or another raster, one GDAL converts, a
Expand Down Expand Up @@ -100,9 +107,10 @@ if the first pair contains coordinates outside ±180° longitude or ±90° latit
specific longitude/latitude pair gives in-range, non-0,0 positions on at least as many rows as
the first pair gives finite positions, that pair is used for the whole file.
The published aliases `Longitude Decimal Degrees`/`Latitude Decimal Degrees` and
`Longitutde`/`Lattitude` are recognised too. The dialog checks its first 1,000 rows to pick
defaults, and recomputes unchanged defaults when you leave the coordinate-system box or press
Enter; columns you picked stay picked. A projected system keeps the columns found by name.
`Longitutde`/`Lattitude` are recognised too. The dialog checks the first 1,000 rows of delimited
text, or every row of a spreadsheet, to pick defaults. It recomputes unchanged defaults when you
leave the coordinate-system box or press Enter; columns you picked stay picked. With a projected system, defaults prefer X/Y or easting/northing
columns over longitude/latitude names when both exist; explicit column picks still take precedence.
Add Data checks all rows. Coordinates still outside degree ranges are counted in a
notice. Points placed at exactly 0,0 are also counted in a notice: these often mean missing
coordinates, but the points are kept. A CSV without coordinate columns, or a layer without geometry, opens as a
Expand All @@ -114,13 +122,15 @@ the table's name beside it (`input_name`). The **XY Table To Point** tool
([Geoprocessing](analysis.md), and a table's right-click menu) makes points of a table already in
the project, from two fields of coordinates and their coordinate system. In a text field a single comma is the decimal separator
(`1,234` is 1.234); thousands separators are not read.
Excel `.xls` records, formula operands and sheet bounds are checked before opening, including
sheets that were not selected. The workbook shares a memory budget across its sheets and retained
metadata. Value and formula grids are counted separately, with conservative estimates for
formula strings, defined names and sheet state. Formula-heavy workbooks can reach this budget
before their value-grid limit. A file with damaged records or excessive allocations is refused with the reason. Normal
cached formula values are read. A formula's direct cell reference to row 65,536 is currently
refused because the XLS reader cannot handle that reference safely.

Excel `.xls` records, formula operands and sheet bounds are checked before opening, including sheets
that were not selected. The workbook shares a memory budget across its sheets and retained metadata.
Value and formula grids are counted separately, with allocation estimates for formula strings,
defined names and sheet state. Formula-heavy workbooks can reach this budget before their value-grid
limit. A file with damaged records or excessive allocations is refused with the reason. Normal
cached formula values are read. A formula's direct cell reference to row 65,536 is currently refused
because the XLS reader cannot handle that reference safely.

**Home › Add › Add Data › Graphics Layer** adds a layer for [drawn graphics](cartography.md#graphics),
and **Data › Layer Templates** adds empty layers with ready-made schemas to draw into.

Expand Down Expand Up @@ -656,7 +666,8 @@ plus `geocoded`, what the geocoder called the place, and a text field `match_sta

Rows that weren't found stay in its table without a point, and a notice counts them; filter
`match_status = 'unmatched'` to review them. A field of the same name in the input is kept, and
the new one gets an underscore appended (`match_status_`; filter that one then). `matched` means the geocoder returned a point, not that
the generated field gets underscores appended until its name is unique (`match_status_`,
`match_status__`, and so on); filter the generated field. `matched` means the geocoder returned a point, not that
it is the exact address: it may be placed along the street or at a broader place. The geocoders
don't give a match score, so there is none in the output.

Expand Down
2 changes: 1 addition & 1 deletion docs/user-guide/editing.md
Original file line number Diff line number Diff line change
Expand Up @@ -370,7 +370,7 @@ opens. A picture from any other server isn't: the pop-up shows **Show Picture**
name, and fetches nothing until you click it, because the request tells that server that someone
opened the data (see [Privacy](../privacy.md)). A spinner shows while a picture is fetched. PNG, JPEG,
WebP and GIF pictures of up to 4 MB and 2048 × 2048 pixels are shown (on every platform; any other
format, such as BMP or TIFF, is "not supported"); the last 16 addresses' pictures are kept for the
format, such as BMP or TIFF, shows "Picture unavailable: … pictures aren't supported"); the last 16 addresses' pictures are kept for the
session, so opening the pop-up again shows the picture without asking again; they are forgotten with
the web layers' cached tiles (signing out of ArcGIS, a login that ends, **Reload Web Layers**). When
one can't be shown, the pop-up says why ("Picture unavailable: …": the server's answer, a network
Expand Down
4 changes: 2 additions & 2 deletions docs/user-guide/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -118,7 +118,7 @@ end, by double-clicking a tab, or with ++ctrl+f1++ (++cmd+f1++ on macOS, where F
key). Click a tab to peek at its commands while collapsed. When the window is narrower than the
ribbon, arrows at its ends scroll it.

### Diagnostics
### Messages

Open **View › Windows › Messages**, click the status-bar notice or **Messages** button,
or search for **Messages** in Command Search (`ui.pane.diagnosticLog`). This troubleshooting
Expand Down Expand Up @@ -273,7 +273,7 @@ in Command Search. Reload rereads the same local source, table or raster subdata
adding other tables from its container. It retains the layer's name, identity, drawing order,
group, visibility, opacity, styling, labels, filters and map camera. Local PMTiles and MBTiles
tile archives have their own **Reload Data** on their Layers row; see
[Maps › Reloading a local tile archive](maps.md).
[Maps › Reloading a local tile archive](maps.md#reloading-a-local-tile-archive-desktop).

Supported targets are linked vectors, rasters (including time-following Zarr variables),
GDAL/DuckDB file-backed layers and editable local GeoPackage tables. GDAL-linked File
Expand Down
8 changes: 7 additions & 1 deletion docs/user-guide/maps.md
Original file line number Diff line number Diff line change
Expand Up @@ -446,7 +446,9 @@ selectable or editable; a tile not yet loaded may need another click once it arr
**Reload** in the Basemap gallery (`map.reloadWebLayers`) clears cached tiles and styles and
fetches them again.

**Reloading a local tile archive (desktop).** After changing a PMTiles or MBTiles file on disk,
### Reloading a local tile archive (desktop)

After changing a PMTiles or MBTiles file on disk,
right-click its row in Layers and choose **Reload Data** (**Reload Tile Archive** in Command
Search). CLI, Python, MCP and the Assistant use
`map.reloadTiles={"index":0}`; `"name"` or catalog `"id"` can select the archive instead.
Expand Down Expand Up @@ -494,6 +496,10 @@ every tile payload. It allows at most **64 MiB stored and 64 MiB decoded index b
index entries**, **4,096 unique directories** (including the root), and **four leaf levels**;
each stored directory read is limited to **16 MiB**. An invalid index or an exceeded validation
budget is an explicit error without eviction, even if an unusually large index is otherwise valid.
Validation also refuses a stored tile range over **16 MiB**, or one outside the header's declared
tile-data section (including a zero-length section with nonempty tile entries). Ordinary loading
can still draw other tiles from such an archive; reload and repair require the replacement's
entire index to pass these checks before changing the source or dropping cached data.

Neither action is available for local archives in the web app, or for remote tile services.
On Windows, an open MBTiles file may not be replaceable while RustGIS holds it open: reload
Expand Down
2 changes: 1 addition & 1 deletion docs/user-guide/sharing.md
Original file line number Diff line number Diff line change
Expand Up @@ -52,7 +52,7 @@ vectors as a layout's PDF is (see Layouts), in the system viewer on desktop; **C
Clipboard** copies a map image. **Export To 3D** writes a layer as a Wavefront OBJ or binary STL model
with polygons extruded by a field (`share.export3d` writes STL when `path` ends in `.stl`). STL
holds closed solids only: lines and zero-height features are left out, zero-area triangles are
skipped, and a cap that can't be triangulated is fanned over its outer ring, filling any holes; one
skipped, and a cap that can't be triangulated is fanned over its outer ring, filling any holes; a cap that
the triangulator can only finish as a fan (a hole touching the outer ring along an edge, for
example) is fanned over what is left of it. Either fan may spill outside the polygon; the notices
say how many. OBJ
Expand Down
Loading