https://github.com/norwegian-geotechnical-institute/fm-gh-bedrock-generator

API connector between Field Manager and Grasshopper to create bedrock elevation mesh and 3D borehole column models.
https://github.com/norwegian-geotechnical-institute/fm-gh-bedrock-generator

api geotechnical-engineering grasshopper3d open-source rhino3d

Last synced: 25 days ago
JSON representation

API connector between Field Manager and Grasshopper to create bedrock elevation mesh and 3D borehole column models.

• Host: GitHub
• URL: https://github.com/norwegian-geotechnical-institute/fm-gh-bedrock-generator
• Owner: norwegian-geotechnical-institute
• License: mit
• Created: 2023-03-28T13:58:20.000Z (almost 2 years ago)
• Default Branch: main
• Last Pushed: 2024-01-18T09:27:06.000Z (12 months ago)
• Last Synced: 2024-01-18T13:06:01.607Z (12 months ago)
• Topics: api, geotechnical-engineering, grasshopper3d, open-source, rhino3d
• Homepage: https://fieldmanager.io
• Size: 1020 KB
• Stars: 0
• Watchers: 2
• Forks: 1
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# fm-gh-bedrock-generator

This script connects [Grasshopper](https://www.rhino3d.com/) to the geotechnical site investigation data platform [Field Manager](https://fieldmanager.io) API to create the following geometries using [Norwegian Total Sounding](https://ngf.no/publikasjoner/melding-nr-9-veiledning-for-utforelse-av-totalsondering-1994/) (TOT) data:

1) Bedrock elevation mesh interpolated with [Delunay triangulation](https://en.wikipedia.org/wiki/Delaunay_triangulation)

2) 3D borehole columns with colour separation on depth_in_soil and depth_in_rock segments

3) Location ID text-tag placed at the terrain point level

Filters are applied to allow only the following data:

1. Total soundings must have status code: *Conducted* or *Approved*

2. Total soundings must have stop code *93* or *94*

**The script is a work in progress and does likely contain bugs and errors that have not been documented**

![Script layout](./figures/fig_1.PNG)

### Release note v.0.1.0

Initial release.

# Requirements

Access to the FIeld Manager API is required. Reach out to [email protected] to learn more. 

This script also requires the following GH plugins to be installed:

1. Swiftlet | https://www.food4rhino.com/en/app/swiftlet

2. Lunchbox | https://www.food4rhino.com/en/app/lunchbox

# Installation

Clone the repo or download the fm-gh-bedrock-generator.gh file and open it in Grasshopper. 

Make sure all required plugins are installed in the Components folder. This folder can be accessed in Grasshopper from File-> Special Folders -> Components Folders. 

When you have copied the plugins to the folder, right click on the files and select Properties. 

Make sure you have Administrator Rights and if needed check the box "Enable".  

# Run the script

After you have opened the fm-gh-bedrock-generator.gh file in Grasshopper, the following input is needed:

1) enter the project number 

2) paste API token from from the Field Manager API website

app.fieldmanager.io/developer

### Check results in Rhino viewport

To see the model in the Rhino viewport, you must click on one of the preview nodes in Grasshopper, and select "zoom on preview" from the menu bar above the canvas, see figure example below: 

![Zoom on preview](./figures/fig_2.PNG)

# Licence

Licensed under the MIT license.

# About Field Manager

[Field Manager](https://fieldmanager.io) is a SaaS solution supporting data management and project collaboration for geotechnical site investigations. The software is developed in-house by the [Norwegian Geotechnical Institute (NGI)](https://www.ngi.no/).

# Contribute

We encourage the community to contribute to the development of this script and hope that you will submit a pull request or start a discussion!