notLang
A simple scripting language for GIS and geospatial analysis.
notLang is a domain-specific language (DSL) built on Python, with English and Uzbek messages. It brings vector/raster GIS analysis, satellite data (Google Earth Engine, Copernicus/Sentinel Hub, NASA GIBS, WorldClim), spatial statistics (Moran's I, LISA, DBSCAN), road-network analysis (OpenStreetMap/osmnx) and 160+ other commands together in one plain syntax.
| 🌐 Website | notgis.top |
| 📚 Documentation | docs.notgis.top |
| ▶️ Playground (in your browser) | play.notgis.top |
| 💻 GitHub | github.com/notGIS/notlang |
| 🧩 VS Code extension | Marketplace: notlang.notlang |
load "area.geojson" as a
buffer a 500 -> buf
connect gee
get "COPERNICUS/S2_SR_HARMONIZED" date "2026-06-01" "2026-06-30" bbox buf cloud_mask index "NDVI(B8,B4)" -> ndvi
zonal_stats ndvi with a stats "mean,max" -> result
table result to "report.html"
Installation
pip install notlang[full]
For a minimal install: pip install notlang. Optional features (GEE, 3D,
hydrology, ...) are added through extras when you need them, for example
pip install notlang[gee,cartography].
Requires Python 3.9 or newer.
| Extra | Adds |
|---|---|
full |
Almost everything below (recommended) |
colab |
A light bundle for Colab (does not re-download packages Colab already has) |
gee |
Google Earth Engine |
jupyter |
%load_ext notlang, ipyleaflet widgets |
webmap, threed |
Interactive maps (folium); 3D (plotly, pyvista) |
spectral, hydrology, interpolation |
Spectral indices; hydrology; kriging |
spatial-stats, timeseries, network |
Moran/LISA/DBSCAN; time series; OSM networks |
cartography, cartography-extra, parquet, vector-io |
Map decorations; zonal stats, static basemaps (incl. OpenFreeMap); Parquet; Fiona |
Windows (CMD / PowerShell)
py -m venv .venv
.venv\Scripts\activate
pip install notlang[full]
notlang --version
If the notlang command is "not found" (the Scripts folder is not on PATH), run
it through Python — the result is identical:
python -m notlang script.ntl
Google Colab
The easiest way in Colab is the colab extra. It adds nearly all features
(GEE, hydrology, interpolation, network analysis, ...) without re-downloading the
heavy packages Colab already ships (ipython, plotly, scikit-learn, xarray,
folium) or the 3D stack (pyvista/vtk/trame):
!pip install -q notlang[colab]
If you need 3D visualization (show3d), add it separately:
!pip install -q notlang[threed].
Usage
notlang # interactive mode (REPL)
notlang script.ntl # run a script file
notlang init project # create a new project template
notlang --version # version
notlang --about # about the author/project
notlang --lang uz ... # message language: en (default) or uz
python -m notlang ... # all of the above, works without PATH too
In Jupyter / Google Colab:
%load_ext notlang
%%notlang
load "area.geojson" as a
info a
webmap a
A Python variable from the notebook can be used inside a string as "$name"
(only in %%notlang):
path = "area.geojson"
%%notlang
load "$path" as a
You can also use it directly from Python:
from notlang import Interpreter
it = Interpreter()
for message in it.run_iter('load "area.geojson" as a\nbuffer a 500 -> b'):
print(message)
gdf = it.variables["b"].data # geopandas.GeoDataFrame
Buffers
Distances are in metres (geographic CRS such as EPSG:4326 are buffered in an automatically chosen UTM zone and returned in the original CRS).
buffer a 500 -> b # feature + outer buffer (default)
buffer a 500 outer -> b # outer ring only
buffer a 500 inner -> b # inner ring only (polygons)
buffer a 500 both -> b # both sides: 500 m inside and 500 m outside
buffer a 500 both to "b.geojson" -> b # buffer and save to GeoJSON in one step
show a, b
Basemaps
show and webmap accept basemap "<name>":
| Name | Source |
|---|---|
street / osm, light, dark, topo, satellite |
Raster tiles (OpenStreetMap, CARTO, OpenTopoMap, Esri) |
bright, liberty, positron, ofm_dark |
OpenFreeMap vector tiles — free, no API key |
OpenFreeMap needs pip install mapbox-vector-tile for static show images
(included in the cartography-extra and full extras).
Language
Messages are English by default. Use language "uz" inside a script, --lang uz
on the command line, or the NOTLANG_LANG=uz environment variable to switch to
Uzbek.
Features
- Vector/raster GIS: buffer (outer / inner / both), clip, zonal statistics, reclassification, hydrology, interpolation (IDW/kriging)
- Satellite platforms: Google Earth Engine (server-side cloud masking, index calculation, Drive/Asset export), Copernicus/Sentinel Hub (6 collections, Statistical API), NASA GIBS, STAC
- Climate data: WorldClim (averages, historical, CMIP6 future projections)
- Spatial statistics: Moran's I, LISA, DBSCAN, K-Means, hotspots (Getis-Ord Gi*)
- Road networks: via OpenStreetMap (osmnx) — download, routing, no API key
- Other open sources: GADM, Natural Earth, GBIF, USGS earthquakes, NASA POWER, SoilGrids, OpenAerialMap, Microsoft Building Footprints, and more
- Visualization: static maps, interactive web maps (widget in Jupyter, standalone HTML elsewhere), 3D views, charts, OpenFreeMap / OSM / CARTO basemaps
- Bilingual: English and Uzbek messages
- Safe formulas:
bandmathandfilter ... whereexpressions are restricted (arithmetic and comparisons only) — arbitrary Python code is never executed - Versioning: with
versioning "on", saved files are never overwritten; each one is saved with a timestamp
Documentation
Full guides (Colab, Windows CMD/PowerShell, GEE, Copernicus, open APIs and new commands) are at docs.notgis.top. You can also try notLang right in your browser at play.notgis.top. The source code is on GitHub.
Editor support
VS Code — the official notLang extension
(v0.9.26): syntax highlighting, IntelliSense (160+ commands), 34 snippets, run a
script with Ctrl+Shift+Enter, a REPL, and results (webmap, 3D, charts) opened
automatically inside VS Code. It finds notLang by itself (venv, notlang or
python -m notlang), on Windows too. Search for "notLang" in the Marketplace or
install the .vsix file (works in Cursor as well). The notlang.language
setting (en / uz) switches the extension's messages.
Syntax highlighting, completions and snippets are also available for Sublime Text and Notepad++.
Author
Xushnudbek Rahimberganov Website: https://notgis.top Email: notgis@proton.me
License
MIT
Metadata
Release files for notlang 0.9.26
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| notlang-0.9.26.tar.gz | 210.8 kB | Without provenance | Details for notlang-0.9.26.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| notlang-0.9.26-py3-none-any.whl | Python 3 | none | any | Details for notlang-0.9.26-py3-none-any.whl |
Total release size: 402.2 kB
Release files / notlang-0.9.26.tar.gz
| Download URL | notlang-0.9.26.tar.gz |
|---|---|
| Size | 210.8 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
9e47e52bbbda49d42b4d971e33f69dfba0dbd92979cecf67d09761c5856093cb
|
|
BLAKE2b-256 checksum How to use checksums |
91b8822838a24b9233d8ed2a9631be9927384f11bfb2d9e7e65de4c22d57b4c9
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.13.15
|
Release files / notlang-0.9.26-py3-none-any.whl
| Download URL | notlang-0.9.26-py3-none-any.whl |
|---|---|
| Size | 191.4 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
399fb0c6175b2d77d97ba40735c9eb1d3c4a0d8a1aeaa489e649a19ac4267a38
|
|
BLAKE2b-256 checksum How to use checksums |
ea2d60c277dc2bbf8690312b4fe92f4909d2edd5909c57a8ae453defe31ea712
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.13.15
|
Security for notlang 0.9.26
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.