Skip to content

Commit b1fd3b6

Browse files
committed
0.1.2 doc updates
1 parent f5323e8 commit b1fd3b6

File tree

7 files changed

+19
-6
lines changed

7 files changed

+19
-6
lines changed

.gitignore

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -10,4 +10,5 @@ wheels/
1010
.venv
1111

1212
# place for working on stuff
13-
junk_drawer/
13+
junk_drawer/
14+
site/

README.md

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -7,6 +7,9 @@ Spatial polars uses [lonboard](https://developmentseed.org/lonboard/latest/) for
77

88
Spatial polars is mostly just glue code connecting the work of others to bring spatial funcitonality to polars.
99

10+
## Documentation
11+
Documentation can be found here: [https://atl2001.github.io/spatial_polars/](https://atl2001.github.io/spatial_polars/)
12+
1013
## Lazily access data
1114
Spatial polars scan_spatial function will scan geoparquet files and any other data source [supported by pyogrio](https://pyogrio.readthedocs.io/en/latest/supported_formats.html) and return a polars lazy frame. A read_spatial function is also provided which simply wraps scan_spatial with a .collect() at the end to return a polars dataframe. The scan_spatial function was the reason this package was created, it is much preferred over the read_spatial function for [the same reasons that polars recommends](https://docs.pola.rs/user-guide/lazy/using/) using the lazy API over the eager API.
1215

docs/index.md

Lines changed: 10 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -9,9 +9,18 @@ Spatial polars is mostly just glue code connecting the work of others to bring s
99

1010
## Installation
1111
Spatial polars can be installed from pypi
12-
```
12+
```title="Install with no optional dependencies"
1313
pip install spatial-polars
1414
```
15+
```title="Install with dependencies for displaying data on a lonboard map"
16+
pip install spatial-polars[lonboard]
17+
```
18+
```title="Install with dependencies to run examples in this guide (installs geodatasets)"
19+
pip install spatial-polars[examples]
20+
```
21+
```title="Install with all optional dependencies"
22+
pip install spatial-polars[lonboard, examples]
23+
```
1524

1625
## Lazily access geospatial data
1726
Spatial polars [scan_spatial](io.md#spatial_polars.io.scan_spatial) function will scan geoparquet files and any other data source [supported by pyogrio](https://pyogrio.readthedocs.io/en/latest/supported_formats.html) and return a [polars LazyFrame](https://docs.pola.rs/api/python/stable/reference/lazyframe/index.html#). A [read_spatial](io.md#spatial_polars.io.read_spatial) function is also provided which simply wraps scan_spatial with a [.collect(streaming=True)][polars.LazyFrame.collect] at the end to return a polars dataframe. The scan_spatial function was the reason this package was created, it is much preferred over the read_spatial function for [the same reasons that polars recommends](https://docs.pola.rs/user-guide/concepts/lazy-api/) using the lazy API over the eager API.

mkdocs.yml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -21,7 +21,7 @@ theme:
2121
repo: fontawesome/brands/github
2222
logo: fontawesome/solid/globe
2323

24-
repo_url: https://github.com/ATL2001/ATL2001/spatial-polars
24+
repo_url: https://github.com/ATL2001/spatial_polars
2525

2626
plugins:
2727
- search

pyproject.toml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
[project]
22
name = "spatial-polars"
3-
version = "0.1.1"
3+
version = "0.1.2" # dont forget __init__.py and uv lock
44
description = "A package that extends polars for working with geospatial data."
55
readme = "README.md"
66
authors = [

src/spatial_polars/__init__.py

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -12,4 +12,4 @@
1212
"SpatialExpr",
1313
]
1414

15-
__version__ = "0.1.1"
15+
__version__ = "0.1.2" # dont forget pyproject.toml and uv lock

uv.lock

Lines changed: 1 addition & 1 deletion
Some generated files are not rendered by default. Learn more about customizing how changed files appear on GitHub.

0 commit comments

Comments
 (0)