Bedrock

The Open Source Foundation for Geotechnical Engineering

Bedrock is an open-source Python library for reading & writing Ground Investigation data in different formats.

๐Ÿ“– 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, NADAG, GEF, or something else? Let us know by creating an issue or starting a discussion.

Also, if you have a project with publicly available GI data, please share that in a discussion, 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) 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 (like a Shapefile, but then waaay better). Such a GeoPackage can then be loaded into ArcGIS, where you can visualize your GI data in 3D:

Kai Tak, Hong Kong, 3D GI data visualization in ArcGIS
GI data in Kai Tak, Hong Kong. Click here to explore for yourself.

๐ŸŸฆ Put your GI data into Speckle

From ArcGIS or QGIS you can publish your GI data to Speckle and then visualize it together with your ground models and civil engineering designs:

Kai Tak, Hong Kong, data from many sources in Speckle.
Models from Rhino, Revit, Civil3D + context & GI data from Q/ArcGIS. Click here to explore for yourself.
GI data, the derived Leapfrog ground model and a tunnel in Speckle.
GI data, the derived Leapfrog ground model and a tunnel in Speckle. Click here to explore for yourself.

Moreover, your GI data becomes available in all the software that Speckle has connectors for.

๐Ÿ”“ 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 and contribute, such that together we can build the tools weโ€™ve always wanted and needed.

๐Ÿ’ญ 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,
  2. Start a discussion in this GitHub repo: Bedrock discussions,
  3. Or start a discussion on the Speckle community forum if thatโ€™s more appropriate: Speckle community forum

All feedback and engagement with the Bedrock community is welcome.

๐Ÿ‘ท Contributing

Caution

Wait, please read this too!

Contributing isnโ€™t scary.

Contributing isnโ€™t just about writing code:

  • Use Bedrock and provide feedback
  • Share how you use Bedrock
  • If you have a project with publicly available GI data, please share that in a discussion, such that we can create a tutorial from it.
  • Help each other out, e.g. by replying to questions in the discussions or bedrock-ge issues ๐Ÿค
  • Spread the word about Bedrock!
  • Documentation and tutorials ๐Ÿ“ƒ
  • Most pages on the 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! ๐Ÿ–ฑ๏ธ๐Ÿ’ฅ

Edit this page on GitHub button on bedrock.engineer

  • If you would like to contribute code, AWESOME! Please create an issue 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.

Professional Support

While bedrock-ge is an Free Open Source Software (FOSS) project, you might be looking for professional support implementing it, contact for more information.