bedrock-ge 0.2.1__tar.gz → 0.2.3__tar.gz

{bedrock_ge-0.2.1 → bedrock_ge-0.2.3}/.gitignore

@@ -1,8 +1,11 @@
 # marimo
 __marimo__/
 
-# Outputs
+# Outputs, logs, tmp, etc.
 **/output
+**/log
+**/tmp
+**/temp
 
 # SQLite Databases
 *.sqlite
@@ -91,10 +94,6 @@ ENV/
 env.bak/
 venv.bak/
 
-# Spyder project settings
-.spyderproject
-.spyproject
-
 # Rope project settings
 .ropeproject
 

{bedrock_ge-0.2.1 → bedrock_ge-0.2.3}/PKG-INFO

@@ -1,7 +1,7 @@
 Metadata-Version: 2.4
 Name: bedrock-ge
-Version: 0.2.1
-Summary: Bedrock, the Open Source Foundation for Ground Engineering
+Version: 0.2.3
+Summary: Bedrock's Python library for geotechnical engineering.
 Project-URL: Homepage, https://bedrock.engineer/
 Project-URL: Source, https://github.com/bedrock-engineer/bedrock-ge
 Project-URL: Documentation, https://bedrock.engineer/docs/
@@ -9,18 +9,26 @@ Project-URL: Tracker, https://github.com/bedrock-engineer/bedrock-ge/issues
 Author-email: Bedrock <info@bedrock.engineer>
 License: Apache Software License (Apache 2.0)
 License-File: LICENSE
-Keywords: aec,ags,bedrock,bim,engineering geology,geo-bim,geotech,geotechnical data,geotechnical engineering,gi data,gis,ground engineering,ground investigation,ground investigation data
-Classifier: Development Status :: 2 - Pre-Alpha
+Keywords: aec,aeco,ags,ags3,ags4,bedrock,bim,borehole,borehole-data,civil-engineering,engineering-geology,geo-bim,geoscience-bim,geosciences,geospatial,geospatial-data,geostatistics,geotech,geotechnical,geotechnical-data,geotechnical-engineering,geotechnics,gi-data,gis,ground-engineering,ground-investigation,ground-investigation-data,subsurface,underground
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Education
+Classifier: Intended Audience :: Science/Research
 Classifier: License :: OSI Approved :: Apache Software License
 Classifier: Operating System :: OS Independent
-Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Scientific/Engineering
+Classifier: Topic :: Scientific/Engineering :: GIS
 Requires-Python: >=3.9
-Requires-Dist: duckdb~=1.0
 Requires-Dist: geopandas~=1.0
 Requires-Dist: openpyxl~=3.0
 Requires-Dist: pandera>=0.23.0
 Requires-Dist: python-ags4~=1.0
-Requires-Dist: sqlglot>=26.12.0
 Requires-Dist: sqlmodel>=0.0.22
 Description-Content-Type: text/markdown
 
@@ -28,19 +36,19 @@ Description-Content-Type: text/markdown
   <img src="https://bedrock.engineer/public/Bedrock_TextRight.png" alt="Bedrock logo" width="75%"/>
 </p>
 
-<h3 align="center">Bedrock, the Open Source Foundation for Ground Investigation Data</h3>
+<h3 align="center">Bedrock, the Open Source Foundation for Geotechnical Engineering</h3>
 
 ---
 
 📃 **Documentation:** <https://bedrock.engineer/docs>
 
-🖥️ **Source Code:** <https://github.com/bedrock-gi/bedrock-gi>
+🖥️ **Source Code:** <https://github.com/bedrock-engineer/bedrock-ge>
 
-🐍 **`bedrock-gi` on PyPI:** <https://pypi.org/project/bedrock-gi/>
+🐍 **`bedrock-ge` on PyPI:** <https://pypi.org/project/bedrock-ge/>
 
 🌐 **Website:** <https://bedrock.engineer/>
 
-🔗 **LinkedIn:** <https://www.linkedin.com/company/bedrock-gi>
+🔗 **LinkedIn:** <https://www.linkedin.com/company/bedrock-engineer>
 
 ---
 
@@ -58,13 +66,13 @@ Description-Content-Type: text/markdown
 | GeoJSON     | ✅  | ✅    |
 
 What do you need? [DIGGS](https://diggsml.org/)? [NADAG](https://www.ngu.no/geologisk-kartlegging/om-nadag-nasjonal-database-grunnundersokelser)? [GEF](https://publicwiki.deltares.nl/display/STREAM/Dutch+National+GEF+Standards)?  Something else?  
-Let us know by creating an [issue](https://github.com/bedrock-gi/bedrock-gi/issues) or starting a [discussion](https://github.com/orgs/bedrock-gi/discussions) 💭
+Let us know by creating an [issue](https://github.com/bedrock-engineer/bedrock-ge/issues) or starting a [discussion](https://github.com/orgs/bedrock-engineer/discussions) 💭
 
-Also, if you have a project with publicly available GI data, please share that in a [discussion](https://github.com/orgs/bedrock-gi/discussions), such that we can create a tutorial from it 🤩
+Also, if you have a project with publicly available GI data, please share that in a [discussion](https://github.com/orgs/bedrock-engineer/discussions), such that we can create a tutorial from it 🤩
 
 ### ✅ Validate your GI data
 
-`bedrock-gi` comes with data validation to make sure that you can combine Ground Investigation data from multiple files into a single GIS database with consistent relationships between GI locations, samples, in-situ measurements and lab tests.
+`bedrock-ge` comes with data validation to make sure that you can combine Ground Investigation data from multiple files into a single GIS database with consistent relationships between GI locations, samples, in-situ measurements and lab tests.
 
 This data validation mechanism (based on [`pandera`](https://pandera.readthedocs.io/en/stable/)) is easily extensible, giving you the power to add your own data validation criteria 💪
 
@@ -90,7 +98,7 @@ Moreover, your GI data becomes available in all the software that [Speckle has c
 
 ### 🔓 Free and Open Source Software
 
-Free and Open Source Software (FOSS) gives you full access to the code, which means you can customize `bedrock-gi` to integrate with other tools and fit your workflows & project needs.
+Free and Open Source Software (FOSS) gives you full access to the code, which means you can customize `bedrock-ge` to integrate with other tools and fit your workflows & project needs.
 
 As the name implies, FOSS is free to use, so you're not tied to expensive software licenses or locked into a specific software vendor ⛓️‍💥
 
@@ -140,10 +148,10 @@ This relational database ([linked tables](https://en.wikipedia.org/wiki/Relation
 
 ## ⬇️ Installation
 
-In case you're using `uv`, you can add `bedrock-gi` to your Python project and install it in your project's virtual environment by running:
+In case you're using `uv`, you can add `bedrock-ge` to your Python project and install it in your project's virtual environment by running:
 
 ```bash
-uv add bedrock-gi
+uv add bedrock-ge
 ```
 
 I would highly recommend anyone to start using [`uv`](https://docs.astral.sh/uv/) (Unified Virtual Environment Manager) if you're not already doing so. Some of the advantages (Source: [`uv`](https://docs.astral.sh/uv/)):
@@ -153,10 +161,10 @@ I would highly recommend anyone to start using [`uv`](https://docs.astral.sh/uv/
 - 🗂️ `uv` provides [comprehensive project management](https://docs.astral.sh/uv/#project-management), with a [universal lockfile](https://docs.astral.sh/uv/concepts/projects/#project-lockfile). This means no more headaches about virtual environments (or having to explain what on earth a virtual env is), or people running different versions of Python or Python packages on the same project, causing errors and other problems.
 - In short, 🚀 `uv` is a single tool to replace `pip`, `pip-tools`, `pipx`, `poetry`, `pyenv`, `virtualenv`, `conda` and more...
 
-It's of course also possible to install `bedrock-gi` from [PyPI](https://pypi.org/project/bedrock-gi/) (Python Packaging Index) using `pip`:
+It's of course also possible to install `bedrock-ge` from [PyPI](https://pypi.org/project/bedrock-ge/) (Python Packaging Index) using `pip`:
 
 ```bash
-pip install bedrock-gi
+pip install bedrock-ge
 ```
 
 ## 💭 Feedback
@@ -165,8 +173,8 @@ Got some feedback, a great idea, running into problems when working with Bedrock
 
 Please feel free to:
 
-1. open an issue for feature requests or bug reports: [`bedrock-gi` issues](https://github.com/bedrock-gi/bedrock-gi/issues),
-2. start a discussion in this GitHub repo: [Bedrock discussions](https://github.com/orgs/bedrock-gi/discussions),
+1. open an issue for feature requests or bug reports: [`bedrock-ge` issues](https://github.com/bedrock-engineer/bedrock-ge/issues),
+2. start a discussion in this GitHub repo: [Bedrock discussions](https://github.com/orgs/bedrock-engineer/discussions),
 3. or start a discussion on the Speckle community forum if that's more appropriate: [Speckle community forum](https://speckle.community/)
 
 All feedback and engagement with the Bedrock community is welcome 🤗
@@ -181,7 +189,7 @@ Contributing isn't just about writing code:
 
 - Use Bedrock and provide [feedback](#-feedback) 🪲
 - Share how you use Bedrock 🏗️
-- Help each other out, e.g. by replying to questions in the [discussions](https://github.com/orgs/bedrock-gi/discussions) or [`bedrock-gi` issues](https://github.com/bedrock-gi/bedrock-gi/issues) 🤝
+- Help each other out, e.g. by replying to questions in the [discussions](https://github.com/orgs/bedrock-engineer/discussions) or [`bedrock-ge` issues](https://github.com/bedrock-engineer/bedrock-ge/issues) 🤝
 - Spread the word about Bedrock 🤩
 - Documentation and tutorials 📃
 - Most pages on the [bedrock.engineer](https://bedrock.engineer/) website can be edited, so if you see a spelling mistake or have a suggestion on how to explain something better, please smash that button! 🖱️💥
@@ -203,13 +211,13 @@ If you want your ground investigation data to go into a GIS database, all GIS ge
 
 Therefore, if you are dealing with GI data collected using different projected CRS's, you'll have to convert the Easting, Northing, z-coordinates to global longitude, latitude, ellipsoidal height coordinates in a geodetic CRS. ([Further reading](https://clover-animantarx-a3a.notion.site/Geomatics-36dfece2dece4358b44c44d08c9cded6))
 
-Please start a [discussion](https://github.com/orgs/bedrock-gi/discussions) or create an issue if want to be able to put data that were collected in different projected CRS's into a single GIS database. This is pretty easy with [`geopandas`](https://geopandas.org/en/stable/) / [`pyproj`](https://pyproj4.github.io/pyproj/stable/) transformations, but hasn't been necessary yet.
+Please start a [discussion](https://github.com/orgs/bedrock-engineer/discussions) or create an issue if want to be able to put data that were collected in different projected CRS's into a single GIS database. This is pretty easy with [`geopandas`](https://geopandas.org/en/stable/) / [`pyproj`](https://pyproj4.github.io/pyproj/stable/) transformations, but hasn't been necessary yet.
 
 ## ✍️ Author
 
 Hi, I'm Joost Gevaert 👋
 
-I studied geotechnical engineering and applied geophysics and then worked for [Arup](https://www.arup.com/) for 4 as a geotechnical engineer an computational designer.
+I studied geotechnical engineering and applied geophysics and then worked for [Arup](https://www.arup.com/) for 4 years as a geotechnical engineer and computational designer.
 
 During my time at Arup I worked a lot on bringing computational design into the world of geotechnical engineering, and on [bridging the gaps between geotechnical engineering and structural engineering](https://www.linkedin.com/posts/joost-gevaert_lightbim-lightbim-lightbim-activity-7234726439835549697-3xdO).
 

{bedrock_ge-0.2.1 → bedrock_ge-0.2.3}/README.md

@@ -2,19 +2,19 @@
   <img src="https://bedrock.engineer/public/Bedrock_TextRight.png" alt="Bedrock logo" width="75%"/>
 </p>
 
-<h3 align="center">Bedrock, the Open Source Foundation for Ground Investigation Data</h3>
+<h3 align="center">Bedrock, the Open Source Foundation for Geotechnical Engineering</h3>
 
 ---
 
 📃 **Documentation:** <https://bedrock.engineer/docs>
 
-🖥️ **Source Code:** <https://github.com/bedrock-gi/bedrock-gi>
+🖥️ **Source Code:** <https://github.com/bedrock-engineer/bedrock-ge>
 
-🐍 **`bedrock-gi` on PyPI:** <https://pypi.org/project/bedrock-gi/>
+🐍 **`bedrock-ge` on PyPI:** <https://pypi.org/project/bedrock-ge/>
 
 🌐 **Website:** <https://bedrock.engineer/>
 
-🔗 **LinkedIn:** <https://www.linkedin.com/company/bedrock-gi>
+🔗 **LinkedIn:** <https://www.linkedin.com/company/bedrock-engineer>
 
 ---
 
@@ -32,13 +32,13 @@
 | GeoJSON     | ✅  | ✅    |
 
 What do you need? [DIGGS](https://diggsml.org/)? [NADAG](https://www.ngu.no/geologisk-kartlegging/om-nadag-nasjonal-database-grunnundersokelser)? [GEF](https://publicwiki.deltares.nl/display/STREAM/Dutch+National+GEF+Standards)?  Something else?  
-Let us know by creating an [issue](https://github.com/bedrock-gi/bedrock-gi/issues) or starting a [discussion](https://github.com/orgs/bedrock-gi/discussions) 💭
+Let us know by creating an [issue](https://github.com/bedrock-engineer/bedrock-ge/issues) or starting a [discussion](https://github.com/orgs/bedrock-engineer/discussions) 💭
 
-Also, if you have a project with publicly available GI data, please share that in a [discussion](https://github.com/orgs/bedrock-gi/discussions), such that we can create a tutorial from it 🤩
+Also, if you have a project with publicly available GI data, please share that in a [discussion](https://github.com/orgs/bedrock-engineer/discussions), such that we can create a tutorial from it 🤩
 
 ### ✅ Validate your GI data
 
-`bedrock-gi` comes with data validation to make sure that you can combine Ground Investigation data from multiple files into a single GIS database with consistent relationships between GI locations, samples, in-situ measurements and lab tests.
+`bedrock-ge` comes with data validation to make sure that you can combine Ground Investigation data from multiple files into a single GIS database with consistent relationships between GI locations, samples, in-situ measurements and lab tests.
 
 This data validation mechanism (based on [`pandera`](https://pandera.readthedocs.io/en/stable/)) is easily extensible, giving you the power to add your own data validation criteria 💪
 
@@ -64,7 +64,7 @@ Moreover, your GI data becomes available in all the software that [Speckle has c
 
 ### 🔓 Free and Open Source Software
 
-Free and Open Source Software (FOSS) gives you full access to the code, which means you can customize `bedrock-gi` to integrate with other tools and fit your workflows & project needs.
+Free and Open Source Software (FOSS) gives you full access to the code, which means you can customize `bedrock-ge` to integrate with other tools and fit your workflows & project needs.
 
 As the name implies, FOSS is free to use, so you're not tied to expensive software licenses or locked into a specific software vendor ⛓️‍💥
 
@@ -114,10 +114,10 @@ This relational database ([linked tables](https://en.wikipedia.org/wiki/Relation
 
 ## ⬇️ Installation
 
-In case you're using `uv`, you can add `bedrock-gi` to your Python project and install it in your project's virtual environment by running:
+In case you're using `uv`, you can add `bedrock-ge` to your Python project and install it in your project's virtual environment by running:
 
 ```bash
-uv add bedrock-gi
+uv add bedrock-ge
 ```
 
 I would highly recommend anyone to start using [`uv`](https://docs.astral.sh/uv/) (Unified Virtual Environment Manager) if you're not already doing so. Some of the advantages (Source: [`uv`](https://docs.astral.sh/uv/)):
@@ -127,10 +127,10 @@ I would highly recommend anyone to start using [`uv`](https://docs.astral.sh/uv/
 - 🗂️ `uv` provides [comprehensive project management](https://docs.astral.sh/uv/#project-management), with a [universal lockfile](https://docs.astral.sh/uv/concepts/projects/#project-lockfile). This means no more headaches about virtual environments (or having to explain what on earth a virtual env is), or people running different versions of Python or Python packages on the same project, causing errors and other problems.
 - In short, 🚀 `uv` is a single tool to replace `pip`, `pip-tools`, `pipx`, `poetry`, `pyenv`, `virtualenv`, `conda` and more...
 
-It's of course also possible to install `bedrock-gi` from [PyPI](https://pypi.org/project/bedrock-gi/) (Python Packaging Index) using `pip`:
+It's of course also possible to install `bedrock-ge` from [PyPI](https://pypi.org/project/bedrock-ge/) (Python Packaging Index) using `pip`:
 
 ```bash
-pip install bedrock-gi
+pip install bedrock-ge
 ```
 
 ## 💭 Feedback
@@ -139,8 +139,8 @@ Got some feedback, a great idea, running into problems when working with Bedrock
 
 Please feel free to:
 
-1. open an issue for feature requests or bug reports: [`bedrock-gi` issues](https://github.com/bedrock-gi/bedrock-gi/issues),
-2. start a discussion in this GitHub repo: [Bedrock discussions](https://github.com/orgs/bedrock-gi/discussions),
+1. open an issue for feature requests or bug reports: [`bedrock-ge` issues](https://github.com/bedrock-engineer/bedrock-ge/issues),
+2. start a discussion in this GitHub repo: [Bedrock discussions](https://github.com/orgs/bedrock-engineer/discussions),
 3. or start a discussion on the Speckle community forum if that's more appropriate: [Speckle community forum](https://speckle.community/)
 
 All feedback and engagement with the Bedrock community is welcome 🤗
@@ -155,7 +155,7 @@ Contributing isn't just about writing code:
 
 - Use Bedrock and provide [feedback](#-feedback) 🪲
 - Share how you use Bedrock 🏗️
-- Help each other out, e.g. by replying to questions in the [discussions](https://github.com/orgs/bedrock-gi/discussions) or [`bedrock-gi` issues](https://github.com/bedrock-gi/bedrock-gi/issues) 🤝
+- Help each other out, e.g. by replying to questions in the [discussions](https://github.com/orgs/bedrock-engineer/discussions) or [`bedrock-ge` issues](https://github.com/bedrock-engineer/bedrock-ge/issues) 🤝
 - Spread the word about Bedrock 🤩
 - Documentation and tutorials 📃
 - Most pages on the [bedrock.engineer](https://bedrock.engineer/) website can be edited, so if you see a spelling mistake or have a suggestion on how to explain something better, please smash that button! 🖱️💥
@@ -177,13 +177,13 @@ If you want your ground investigation data to go into a GIS database, all GIS ge
 
 Therefore, if you are dealing with GI data collected using different projected CRS's, you'll have to convert the Easting, Northing, z-coordinates to global longitude, latitude, ellipsoidal height coordinates in a geodetic CRS. ([Further reading](https://clover-animantarx-a3a.notion.site/Geomatics-36dfece2dece4358b44c44d08c9cded6))
 
-Please start a [discussion](https://github.com/orgs/bedrock-gi/discussions) or create an issue if want to be able to put data that were collected in different projected CRS's into a single GIS database. This is pretty easy with [`geopandas`](https://geopandas.org/en/stable/) / [`pyproj`](https://pyproj4.github.io/pyproj/stable/) transformations, but hasn't been necessary yet.
+Please start a [discussion](https://github.com/orgs/bedrock-engineer/discussions) or create an issue if want to be able to put data that were collected in different projected CRS's into a single GIS database. This is pretty easy with [`geopandas`](https://geopandas.org/en/stable/) / [`pyproj`](https://pyproj4.github.io/pyproj/stable/) transformations, but hasn't been necessary yet.
 
 ## ✍️ Author
 
 Hi, I'm Joost Gevaert 👋
 
-I studied geotechnical engineering and applied geophysics and then worked for [Arup](https://www.arup.com/) for 4 as a geotechnical engineer an computational designer.
+I studied geotechnical engineering and applied geophysics and then worked for [Arup](https://www.arup.com/) for 4 years as a geotechnical engineer and computational designer.
 
 During my time at Arup I worked a lot on bringing computational design into the world of geotechnical engineering, and on [bridging the gaps between geotechnical engineering and structural engineering](https://www.linkedin.com/posts/joost-gevaert_lightbim-lightbim-lightbim-activity-7234726439835549697-3xdO).
 

{bedrock_ge-0.2.1 → bedrock_ge-0.2.3}/RELEASE.md

@@ -1,4 +1,4 @@
-# Releasing a new version of `bedrock-gi`
+# Releasing a new version of `bedrock-ge`
 
 ## 1. Update the Version Number
 
@@ -75,14 +75,14 @@ uv publish
 ## 10. Verify the Release
 
 Check that the new version is available on PyPI:  
-<https://pypi.org/project/bedrock-gi/>
+<https://pypi.org/project/bedrock-ge/>
 
 Install the new Python package version in a clean environment to verify it works:
 
 ```bash
-uv run --with bedrock-gi --no-project -- python -c "import bedrock; print(f'bedrock-gi version: {bedrock.__version__}')"
+uv run --with bedrock-ge --no-project -- python -c "import bedrock_ge; print(f'bedrock-ge version: {bedrock_ge.__version__}')"
 ```
 
 ## 11. Create a GitHub Release
 
-Create a new release based on the tag: [github.com/bedrock-gi/bedrock-gi/releases](https://github.com/bedrock-gi/bedrock-gi/releases).
+Create a new release based on the tag: [github.com/bedrock-engineer/bedrock-ge/releases](https://github.com/bedrock-engineer/bedrock-ge/releases).

bedrock_ge-0.2.3/examples/README.md

@@ -0,0 +1,82 @@
+# `bedrock-ge` examples
+
+This folder contains example notebooks that guide you how to use Bedrock's Geotechnical Engineering Python package `bedrock-ge`.
+
+## How to run the example notebooks
+
+The notebooks are available as [marimo](https://marimo.io/) (`.py` extension) as well as [Jupyter](https://jupyter.org/) notebooks (`.ipynb` extension). However, it is **STRONGLY** recommended to use the marimo notebooks, as they are more user-friendly and have [several other advantages over Jupyter notebooks](https://docs.marimo.io/#highlights).
+
+Both the marimo notebooks as well as the Jupyter notebooks can be run online, i.e. remotely, or on your own computer, i.e. locally.
+
+### marimo
+
+marimo notebooks are normal Python files, and therefore have the `.py` extension.
+
+#### Remotely: marimo playground
+
+marimo notebooks on GitHub can directly be run remotely in the [marimo playground](https://docs.marimo.io/guides/publishing/playground/#open-notebooks-hosted-on-github). To open the notebooks in this repository:
+
+1. Navigate to one of them, e.g.  
+   The Kai Tak, Hong Kong AGS 3 example: [hk_kaitak_ags3/hk_kaitak_ags3_to_brgi_geodb.py](https://github.com/bedrock-engineer/bedrock-ge/blob/main/examples/hk_kaitak_ags3/hk_kaitak_ags3_to_brgi_geodb.py)
+2. Copy the GitHub URL of the notebook you want to try, e.g.  
+    https://github.com/bedrock-engineer/bedrock-ge/blob/main/examples/hk_kaitak_ags3/hk_kaitak_ags3_to_brgi_geodb.py
+3. Open a new tab and go to `marimo.app/<Ctrl + V the copied GitHub URL>`, e.g.
+    https://marimo.app/https://github.com/bedrock-engineer/bedrock-ge/blob/dev/examples/hk_kaitak_ags3/hk_kaitak_ags3_to_brgi_geodb.py
+
+#### Locally: on your own computer
+
+Running the marimo notebooks in this repo locally is very easy if you're using [`uv`](https://docs.astral.sh/uv/) to manage Python. In case you're not usinng `uv` to manage Python yet, make sure to give it a try! (INCLUDE A LINK TO BEDROCK DOCS ON HOW TO INSTALL `uv`.)
+
+Managing Python with `uv` will save you many many headaches w.r.t. managing virtual environments, Python packages, etc. etc. etc. Probably the greatest thing about `uv` is that you don't really need to understand what a virtual environment is...
+
+To run a marimo notebook from this repo locally:
+
+1. Download the notebook
+2. Open the terminal
+3. Navigate to the directory where you downloaded the marimo notebook with `cd` (change directory). On Windows this could be:
+   ```bash
+   cd %USERPROFILE%\Downloads
+   ```
+4. Run the marimo notebook with:
+   ```bash
+   uvx marimo edit --sandbox marimo_notebook.py
+   ```
+
+### Jupyter
+
+Jupyter notebooks have the `.ipynb` extension, which is short for Interactive Python NoteBook.
+
+#### Remotely: Google Colab
+
+1. Navigate to one of them, e.g.  
+   The Kai Tak, Hong Kong AGS 3 example: [hk_kaitak_ags3/hk_kaitak_ags3_to_brgi_geodb.ipynb](https://github.com/bedrock-engineer/bedrock-ge/blob/main/examples/hk_kaitak_ags3/hk_kaitak_ags3_to_brgi_geodb.ipynb)
+2. Copy the GitHub URL of the notebook you want to try, e.g.  
+    https://github.com/bedrock-engineer/bedrock-ge/blob/main/examples/hk_kaitak_ags3/hk_kaitak_ags3_to_brgi_geodb.ipynb
+3. Navigate to [colab.research.google.com](https://colab.research.google.com/)
+4. Paste the GitHub URL in the GitHub > Enter a GitHub URL... field
+
+#### Locally: on your own computer
+
+How much do we need to go into detail on how to run a Jupyter Notebook?
+
+I think that if people don't know how to run a Jupyter notebook they should simply use the marimo notebook. The only reason to not use marimo, is when a company uses some deployed Jupyter service like Google Colab, Jupyter Hub or something like that, in which case they should run the Jupyter notebook remotely.
+
+## Eporting marimo notebooks to other formats
+
+### Jupyter Notebook
+
+```bash
+marimo export ipynb --sandbox --sort top-down --include-outputs hk_kaitak_ags3_to_brgi_geodb.py -o hk_kaitak_ags3_to_brgi_geodb.ipynb
+```
+
+After or before exporting a marimo notebook to a Jupyter notebook, the cell with the import statements and the cell(s) with function definitions have to be moved to the top of the Jupyter notebook for it to work. Additionally, in order for Google Colab to be able to run the notebook, you need to install `bedrock-ge` and a few other Python libraries by adding the following cell to the very top of the Jupyter notebook:
+
+```bash
+! pip install bedrock-ge folium mapclassify marimo --quiet
+```
+
+### HTML WebAssembly (WASM)
+
+```bash
+marimo export html-wasm --sandbox --mode edit hk_kaitak_ags3_to_brgi_geodb.py -o output
+```