<figure style="margin-inline: block;">
<img src="https://bedrock.engineer/public/Bedrock_TextRight.png" alt="Bedrock logo" width="75%"/>
</figure>
<h3 style="margin-inline: block;">Bedrock, the Open Source Foundation for Geotechnical Engineering</h3>
---
🌐 **Website:** <https://bedrock.engineer/>
📃 **Documentation:** <https://bedrock.engineer/docs>
📃 **API Reference:** <https://bedrock.engineer/reference/>
🖥️ **Source Code:** <https://github.com/bedrock-engineer/bedrock-ge>
🐍 **`bedrock-ge` on PyPI:** <https://pypi.org/project/bedrock-ge/>
🔗 **LinkedIn:** <https://www.linkedin.com/company/bedrock-engineer>
---
## Overview
> **Definition of Bedrock**
>
> In an abstract sense, the bedrock refers to the main principles something is based on. [1]
>
> In the real world, the bedrock is the hard area of rock in the ground that holds up the loose soil above. [1]
>
> In many civil engineering projects, the identification of the bedrock through digging, drilling or geophysical methods is an important task, which greatly influences (geotechnical) design. [2]
>
> Sources: [[1] Bedrock | Cambridge Dictionary](https://dictionary.cambridge.org/us/dictionary/english/bedrock), [[2] Bedrock | Wikipedia](https://en.wikipedia.org/wiki/Bedrock)
Ground Investigation (GI) data is often trapped in legacy formats that limit analysis and visualization possibilities.
`bedrock-ge` lets you transform this data from specialized geotechnical formats and common tabular formats (Excel, CSV) into modern, standardized geospatial data.
This standardization lets you bridge the gap between raw geotechnical data, the modern Python (geo)scientific ecosystem and modern geospatial tools.
This gives geotechnical engineers greater flexibility in visualization, modeling, and integration across different software environments while avoiding vendor lock-in.
For example, this enables connecting your GI data with GIS as well as BIM environments through [platforms like Speckle](#-put-your-gi-data-into-speckle).
The purpose of Bedrock is NOT to become THE standard for geotechnical data, because [we don't need 15 instead of 14 competing standards](https://xkcd.com/927/).
## Highlights
### 📖 Read / write Ground Investigation (GI) data in different formats
| Data Format | Read | Write |
| ----------- | ---- | ----- |
| AGS 3 | ✅ | ❌ |
| AGS 4 | ✅ | ✅ |
| Excel | ✅ | ✅ |
| CSV | ✅ | ✅ |
| JSON | ✅ | ✅ |
| GeoJSON | ✅ | ✅ |
Do you need another format? Like [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), or something else?
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-engineer/discussions), such that we can create a tutorial from it.
### ✅ Validate your GI data
`bedrock-ge` comes with data validation to make sure that you can combine Ground Investigation data from multiple files into a single geospatial 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.
### 🗺️ Put your GI data from multiple files into a single 3D geospatial database
For example, you can take GI data from 100 AGS files and combine them into a single a [GeoPackage](https://en.wikipedia.org/wiki/GeoPackage) ([like a Shapefile, but then waaay better](http://switchfromshapefile.org/)). Such a GeoPackage can then be loaded into ArcGIS, where you can visualize your GI data in 3D:
<figure style="margin-inline: block; display: block;">
<img src="https://bedrock.engineer/public/images/KaiTak_BrGI_ArcGIS.webp" alt="Kai Tak, Hong Kong, 3D GI data visualization in ArcGIS" width="90%"/>
<figcaption>
GI data in Kai Tak, Hong Kong. <a href="https://arcg.is/0r9DG9">Click here to explore for yourself.</a>
</figcaption>
</figure>
### 🟦 Put your GI data into Speckle
From ArcGIS or QGIS you can publish your GI data to [Speckle](https://speckle.systems/) and then visualize it together with your ground models and civil engineering designs:
<figure style="margin-inline: block; display: block;">
<img src="https://bedrock.engineer/public/images/KaiTak_BrGI_Speckle.png" alt="Kai Tak, Hong Kong, data from many sources in Speckle." width="90%"/>
<figcaption>
Models from Rhino, Revit, Civil3D + context & GI data from Q/ArcGIS. <a href="https://app.speckle.systems/projects/013aaf06e7/models/0fa0287ba8,1cbe68ed69,44c8d1ecae,7f9d99cae2,9535541c2b,a739490298,ff81bfa02b">Click here to explore for yourself.</a>
</figcaption>
</figure>
<figure style="margin-inline: block; display: block;">
<img src="https://bedrock.engineer/public/images/WekaHills_Speckle.webp" alt="GI data, the derived Leapfrog ground model and a tunnel in Speckle." width="90%"/>
<figcaption>
GI data, the derived Leapfrog ground model and a tunnel in Speckle. <a href="https://app.speckle.systems/projects/7a489ac0d4/models/$epsg:2193-7839%2Fgeo%2Fgeology-model,65b4cf97d5,9069ef2b2b">Click here to explore for yourself.</a>
</figcaption>
</figure>
Moreover, your GI data becomes available in all the software that [Speckle has connectors for](https://app.speckle.systems/downloads).
### 🔓 Free and Open Source Software
`bedrock-ge` is Free and Open Source Software (FOSS), meaning it gives you full access to the code, and you can customize `bedrock-ge` to integrate with other tools and fit your workflows and 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.
You can give [feedback](#-feedback) and [contribute](#-contributing), such that together we can build the tools we've always wanted and needed.
## Installation
We recommend to use [`uv`](https://docs.astral.sh/uv/) to manage Python for you.
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-ge
```
It's also possible to install `bedrock-ge` from [PyPI](https://pypi.org/project/bedrock-ge/) (Python Packaging Index) using `pip`:
```bash
pip install bedrock-ge
```
## Feedback
Got some feedback, a great idea, running into problems when working with Bedrock or just want to ask some questions?
Please feel free to:
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.
## Contributing
Contributing isn't scary. Contributing isn't just about writing code:
- Spread the word about Bedrock
- 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-engineer/discussions) or [`bedrock-ge` issues](https://github.com/bedrock-engineer/bedrock-ge/issues)
- 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, click this button to make a contribition.
<figure style="margin-inline: block;">
<img src="https://bedrock.engineer/public/images/EditThisPage.png" alt="Edit this page on GitHub button on bedrock.engineer" width="25%"/>
</figure>
- If you would like to contribute code, awesome!
Please create an [issue](https://github.com/bedrock-engineer/bedrock-ge/issues) for what you'd like to contribute. If you don't know how to get started, please indicate this in your issue, and we'll help you out.
## Maintainers
### Joost
> 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](https://www.arup.com/services/computational-and-parametric-design/).
>
> 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 is the Free and Open Source Software (FOSS) that I wish existed when I worked as a geotechnical engineer at Arup.
### Jules
> I studied Applied Geoscience (Petroleum Engineering Reservoir Geology) but frustration with technical software led me to learn to code and as a result, I mostly worked in software development.
>
> Over the past 5 years, I’ve worked on data-rich applications across various domains, specifically in frontend development.
> My primary interest is figuring out how to build tools for more thoughtful display and processing of technical information, for geoscience in particular.
## Contributors
Please take a look at the [contributors page](https://github.com/bedrock-engineer/bedrock-ge/graphs/contributors).
## Professional Support
While `bedrock-ge` is an Free Open Source Software (FOSS) project, you might be looking for professional support implementing it, contact <info@bedrock.engineer> for more information.
Raw data
{
"_id": null,
"home_page": null,
"name": "bedrock-ge",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.10",
"maintainer_email": null,
"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",
"author": null,
"author_email": "Bedrock <info@bedrock.engineer>",
"download_url": "https://files.pythonhosted.org/packages/f0/f4/e12bdf1af1b590fc973bc944d8115160b351abff59a065ceee4fe8cf2bf5/bedrock_ge-0.3.2.tar.gz",
"platform": null,
"description": "<figure style=\"margin-inline: block;\">\n <img src=\"https://bedrock.engineer/public/Bedrock_TextRight.png\" alt=\"Bedrock logo\" width=\"75%\"/>\n</figure>\n\n<h3 style=\"margin-inline: block;\">Bedrock, the Open Source Foundation for Geotechnical Engineering</h3>\n\n---\n\n\ud83c\udf10 **Website:** <https://bedrock.engineer/>\n\n\ud83d\udcc3 **Documentation:** <https://bedrock.engineer/docs>\n\n\ud83d\udcc3 **API Reference:** <https://bedrock.engineer/reference/>\n\n\ud83d\udda5\ufe0f **Source Code:** <https://github.com/bedrock-engineer/bedrock-ge>\n\n\ud83d\udc0d **`bedrock-ge` on PyPI:** <https://pypi.org/project/bedrock-ge/>\n\n\ud83d\udd17 **LinkedIn:** <https://www.linkedin.com/company/bedrock-engineer>\n\n---\n\n## Overview\n\n> **Definition of Bedrock**\n>\n> In an abstract sense, the bedrock refers to the main principles something is based on. [1]\n>\n> In the real world, the bedrock is the hard area of rock in the ground that holds up the loose soil above. [1]\n>\n> In many civil engineering projects, the identification of the bedrock through digging, drilling or geophysical methods is an important task, which greatly influences (geotechnical) design. [2]\n>\n> Sources: [[1] Bedrock | Cambridge Dictionary](https://dictionary.cambridge.org/us/dictionary/english/bedrock), [[2] Bedrock | Wikipedia](https://en.wikipedia.org/wiki/Bedrock)\n\nGround Investigation (GI) data is often trapped in legacy formats that limit analysis and visualization possibilities.\n`bedrock-ge` lets you transform this data from specialized geotechnical formats and common tabular formats (Excel, CSV) into modern, standardized geospatial data.\n\nThis standardization lets you bridge the gap between raw geotechnical data, the modern Python (geo)scientific ecosystem and modern geospatial tools.\nThis gives geotechnical engineers greater flexibility in visualization, modeling, and integration across different software environments while avoiding vendor lock-in.\nFor example, this enables connecting your GI data with GIS as well as BIM environments through [platforms like Speckle](#-put-your-gi-data-into-speckle).\n\nThe purpose of Bedrock is NOT to become THE standard for geotechnical data, because [we don't need 15 instead of 14 competing standards](https://xkcd.com/927/). \n\n## Highlights\n\n### \ud83d\udcd6 Read / write Ground Investigation (GI) data in different formats\n\n| Data Format | Read | Write |\n| ----------- | ---- | ----- |\n| AGS 3 | \u2705 | \u274c |\n| AGS 4 | \u2705 | \u2705 |\n| Excel | \u2705 | \u2705 |\n| CSV | \u2705 | \u2705 |\n| JSON | \u2705 | \u2705 |\n| GeoJSON | \u2705 | \u2705 |\n\nDo you need another format? Like [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), or something else?\nLet 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).\n\nAlso, 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.\n\n### \u2705 Validate your GI data\n\n`bedrock-ge` comes with data validation to make sure that you can combine Ground Investigation data from multiple files into a single geospatial database with consistent relationships between GI locations, samples, in-situ measurements and lab tests.\n\nThis 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.\n\n### \ud83d\uddfa\ufe0f Put your GI data from multiple files into a single 3D geospatial database\n\nFor example, you can take GI data from 100 AGS files and combine them into a single a [GeoPackage](https://en.wikipedia.org/wiki/GeoPackage) ([like a Shapefile, but then waaay better](http://switchfromshapefile.org/)). Such a GeoPackage can then be loaded into ArcGIS, where you can visualize your GI data in 3D:\n\n<figure style=\"margin-inline: block; display: block;\">\n <img src=\"https://bedrock.engineer/public/images/KaiTak_BrGI_ArcGIS.webp\" alt=\"Kai Tak, Hong Kong, 3D GI data visualization in ArcGIS\" width=\"90%\"/> \n <figcaption>\n GI data in Kai Tak, Hong Kong. <a href=\"https://arcg.is/0r9DG9\">Click here to explore for yourself.</a>\n</figcaption>\n</figure>\n\n### \ud83d\udfe6 Put your GI data into Speckle\n\nFrom ArcGIS or QGIS you can publish your GI data to [Speckle](https://speckle.systems/) and then visualize it together with your ground models and civil engineering designs:\n\n<figure style=\"margin-inline: block; display: block;\">\n <img src=\"https://bedrock.engineer/public/images/KaiTak_BrGI_Speckle.png\" alt=\"Kai Tak, Hong Kong, data from many sources in Speckle.\" width=\"90%\"/> \n <figcaption>\n Models from Rhino, Revit, Civil3D + context & GI data from Q/ArcGIS. <a href=\"https://app.speckle.systems/projects/013aaf06e7/models/0fa0287ba8,1cbe68ed69,44c8d1ecae,7f9d99cae2,9535541c2b,a739490298,ff81bfa02b\">Click here to explore for yourself.</a>\n</figcaption>\n</figure>\n\n<figure style=\"margin-inline: block; display: block;\">\n <img src=\"https://bedrock.engineer/public/images/WekaHills_Speckle.webp\" alt=\"GI data, the derived Leapfrog ground model and a tunnel in Speckle.\" width=\"90%\"/> \n <figcaption>\n GI data, the derived Leapfrog ground model and a tunnel in Speckle. <a href=\"https://app.speckle.systems/projects/7a489ac0d4/models/$epsg:2193-7839%2Fgeo%2Fgeology-model,65b4cf97d5,9069ef2b2b\">Click here to explore for yourself.</a>\n</figcaption>\n</figure>\n\nMoreover, your GI data becomes available in all the software that [Speckle has connectors for](https://app.speckle.systems/downloads).\n\n### \ud83d\udd13 Free and Open Source Software\n\n`bedrock-ge` is Free and Open Source Software (FOSS), meaning it gives you full access to the code, and you can customize `bedrock-ge` to integrate with other tools and fit your workflows and project needs.\n\nAs the name implies, FOSS is free to use, so you're not tied to expensive software licenses or locked into a specific software vendor.\n\nYou can give [feedback](#-feedback) and [contribute](#-contributing), such that together we can build the tools we've always wanted and needed.\n\n## Installation\n\nWe recommend to use [`uv`](https://docs.astral.sh/uv/) to manage Python for you.\nUsing `uv`, you can add `bedrock-ge` to your Python project and install it in your project's virtual environment by running:\n\n```bash\nuv add bedrock-ge\n```\n\nIt's also possible to install `bedrock-ge` from [PyPI](https://pypi.org/project/bedrock-ge/) (Python Packaging Index) using `pip`:\n\n```bash\npip install bedrock-ge\n```\n\n## Feedback\n\nGot some feedback, a great idea, running into problems when working with Bedrock or just want to ask some questions?\n\nPlease feel free to:\n\n1. Open an issue for feature requests or bug reports: [`bedrock-ge` issues](https://github.com/bedrock-engineer/bedrock-ge/issues),\n2. Start a discussion in this GitHub repo: [Bedrock discussions](https://github.com/orgs/bedrock-engineer/discussions),\n3. Or start a discussion on the Speckle community forum if that's more appropriate: [Speckle community forum](https://speckle.community/)\n\nAll feedback and engagement with the Bedrock community is welcome.\n\n## Contributing\n\nContributing isn't scary. Contributing isn't just about writing code:\n\n- Spread the word about Bedrock\n- Use Bedrock and provide [feedback](#-feedback)\n- Share how you use Bedrock\n- 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)\n- Documentation and tutorials\n- 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, click this button to make a contribition.\n\n<figure style=\"margin-inline: block;\">\n <img src=\"https://bedrock.engineer/public/images/EditThisPage.png\" alt=\"Edit this page on GitHub button on bedrock.engineer\" width=\"25%\"/>\n</figure>\n\n- If you would like to contribute code, awesome!\n Please create an [issue](https://github.com/bedrock-engineer/bedrock-ge/issues) for what you'd like to contribute. If you don't know how to get started, please indicate this in your issue, and we'll help you out.\n\n## Maintainers\n\n### Joost\n\n> 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](https://www.arup.com/services/computational-and-parametric-design/).\n>\n> 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).\n>\n> Bedrock is the Free and Open Source Software (FOSS) that I wish existed when I worked as a geotechnical engineer at Arup.\n\n### Jules\n\n> I studied Applied Geoscience (Petroleum Engineering Reservoir Geology) but frustration with technical software led me to learn to code and as a result, I mostly worked in software development.\n>\n> Over the past 5 years, I\u2019ve worked on data-rich applications across various domains, specifically in frontend development.\n> My primary interest is figuring out how to build tools for more thoughtful display and processing of technical information, for geoscience in particular.\n\n## Contributors\n\nPlease take a look at the [contributors page](https://github.com/bedrock-engineer/bedrock-ge/graphs/contributors).\n\n## Professional Support\n\nWhile `bedrock-ge` is an Free Open Source Software (FOSS) project, you might be looking for professional support implementing it, contact <info@bedrock.engineer> for more information.\n",
"bugtrack_url": null,
"license": "Apache Software License (Apache 2.0)",
"summary": "Bedrock's Python library for geotechnical engineering.",
"version": "0.3.2",
"project_urls": {
"Documentation": "https://bedrock.engineer/docs/",
"Homepage": "https://bedrock.engineer/",
"Source": "https://github.com/bedrock-engineer/bedrock-ge",
"Tracker": "https://github.com/bedrock-engineer/bedrock-ge/issues"
},
"split_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"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "a2157fe9c1ede3be7dd8629941c889a12607a2d41d2a14f8afad022916c91b2f",
"md5": "c26835b2bce4bd4904a2c319518b8376",
"sha256": "730c4d04595fea4a28bcdb43ebca554d3beef84c7d49be85681239a75ddfa9e9"
},
"downloads": -1,
"filename": "bedrock_ge-0.3.2-py3-none-any.whl",
"has_sig": false,
"md5_digest": "c26835b2bce4bd4904a2c319518b8376",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.10",
"size": 100931,
"upload_time": "2025-07-14T09:33:53",
"upload_time_iso_8601": "2025-07-14T09:33:53.740900Z",
"url": "https://files.pythonhosted.org/packages/a2/15/7fe9c1ede3be7dd8629941c889a12607a2d41d2a14f8afad022916c91b2f/bedrock_ge-0.3.2-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "f0f4e12bdf1af1b590fc973bc944d8115160b351abff59a065ceee4fe8cf2bf5",
"md5": "6c9750c5dcd267a854299fbe41e401d9",
"sha256": "bed9cc78372fc699f713598c321cf7abac407f35f2cafd79c9a5705c0dbfe12e"
},
"downloads": -1,
"filename": "bedrock_ge-0.3.2.tar.gz",
"has_sig": false,
"md5_digest": "6c9750c5dcd267a854299fbe41e401d9",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.10",
"size": 19238278,
"upload_time": "2025-07-14T09:34:06",
"upload_time_iso_8601": "2025-07-14T09:34:06.757328Z",
"url": "https://files.pythonhosted.org/packages/f0/f4/e12bdf1af1b590fc973bc944d8115160b351abff59a065ceee4fe8cf2bf5/bedrock_ge-0.3.2.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-07-14 09:34:06",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "bedrock-engineer",
"github_project": "bedrock-ge",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "bedrock-ge"
}
JSON
