-
Notifications
You must be signed in to change notification settings - Fork 0
/
Copy pathindex.qmd
104 lines (68 loc) · 5.67 KB
/
index.qmd
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
---
title: "Bedrock"
format:
html:
subtitle: "The Open Source Foundation for Geotechnical Engineering"
toc: false
repo-actions: false
link-external-icon: false
---
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
Ground Investigation data is often stored in specialized file formats that are not easily accessible for modern (geospatial) analysis and visualization workflows.
Bedrock transforms GI data from file formats into structured data, making it accessible for a wide range of applications.
| Data Format | Read | Write |
|-------------|------|-------|
| AGS 3 | ✅ | ❌ |
| AGS 4 | ✅ | ✅ |
| Excel | ✅ | ✅ |
| CSV | ✅ | ✅ |
| JSON | ✅ | ✅ |
| GeoJSON | ✅ | ✅ |
Do you need another format? [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-engineer/bedrock-ge/issues) or starting a [discussion](https://github.com/orgs/bedrock-ge/discussions) on GitHub💭.
## ✅ 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 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 💪
## 🗺️ Put your GI data from multiple files into a single 3D GIS 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 waaay better](http://switchfromshapefile.org/)).
A GeoPackage can then be loaded into QGIS or ArcGIS, such that you can visualize your GI data in 3D, and perform analyses:
<p style="text-align:center;">
<img src="https://bedrock.engineer/public/images/KaiTak_BrGI_ArcGIS.gif" alt="GI data visualization .gif in 3D in ArcGIS" width="90%"/>
</p>
## 🟦 Put your GI data into Speckle
Once you have your GI data inside [Speckle](https://speckle.systems/), it's super easy to visualize GI data together with civil engineering designs:
<p style="text-align:center;">
<img src="https://bedrock.engineer/public/images/KaiTak_BrGI_Speckle.png" alt="Kai Tak, Hong Kong, data from many sources." width="56%" />
<img src="https://bedrock.engineer/public/images/BPFoundation.png" alt="Bored Pile foundation design." width="40%" />
<a href="https://app.speckle.systems/projects/013aaf06e7/models/0fa0287ba8@dfbec71408,1cbe68ed69@d3c4a34cff,44c8d1ecae@b962e2f29d,7f9d99cae2@bbed7cf165,9535541c2b@fafe06f9c0,a739490298@e858cc8cb3,ff81bfa02b@dda7c2f981" target="_blank">Click here to go to the Kai Tak Speckle project from the left image</a>
</p>
Moreover, your GI data becomes available in all the software that [Speckle has connectors for](https://www.speckle.systems/connectors).
## 🔓 Free and Open Source Software
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 ⛓️💥
You can give [feedback](#-feedback) and [contribute](#-contributing), such that together we together can build the tools we've always wanted and needed 🤝
<br>
## 💭 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-ge/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
::: {.callout-caution}
Wait, please read this too!
:::
Contributing isn't scary 😄
Contributing isn't just about writing code:
- Use Bedrock and provide [feedback](#-feedback) 🪲
- Share how you use Bedrock 🏗️
- If you have a project with publicly available GI data, please share that in a [discussion](https://github.com/orgs/bedrock-ge/discussions), such that we can create a tutorial from it.
- Help each other out, e.g. by replying to questions in the [discussions](https://github.com/orgs/bedrock-ge/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! 🖱️💥
<img src="https://bedrock.engineer/public/images/EditThisPage.png" alt="Edit this page on GitHub button on bedrock.engineer" width="20%" style="border: 1px solid #333;" />
- 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.