Skip to main content

Downloads Monthly Downloads Socket Docs License PyPI Deps.dev Python

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: bandmath and filter ... where expressions 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)

Source distribution for notlang 0.9.26
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)

Table of built distributions (wheels) for notlang 0.9.26
File Interpreter ABI Platform Actions
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.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page