[](https://doi.org/10.5194/gmd-14-5063-2021)
[](https://github.com/Loop3D/map2loop/actions/workflows/linting_and_testing.yml)
[](https://github.com/Loop3D/map2loop/actions/workflows/documentation.yml)
# Map2Loop 3.2
Generate 3D geological model inputs from geological maps — a high-level implementation and extension of the original map2loop code developed by Prof. Mark Jessell at UWA. To see an example interactive model built with map2loop and LoopStructural, follow this link:
<a href="http://tectonique.net/models/brockman_syncline.html">3D Model from the Hamersley region, Western Australia</a>
## Install
#### Option 1: Install with Anaconda
This is the simplest and recommended installation process, with:
```bash
conda install -c loop3d -c conda-forge map2loop
```
#### Option 2: Install with pip
Installation with pip will require that GDAL is installed on your system prior to map2loop installation.
This is because GDAL cannot be installed <a href='https://hackernoon.com/hn-images/1*m4cnTYJWM7Rmpsju8dSHmQ.jpeg'>via pip</a> (at least not with one line of code), and the GDAL installation process will vary depending on your OS.
For more information on installing gdal, see <a href="https://pypi.org/project/GDAL/">GDAL's Pypi</a> page.
Once GDAL is available on your system, map2loop can be installed with:
```bash
pip install map2loop
```
#### Option 3: From source
```bash
git clone https://github.com/Loop3D/map2loop.git
cd map2loop
conda install gdal
conda install -c loop3d -c conda-forge --file dependencies.txt
pip install .
```
#### Option 4: From source & developer mode:
```bash
git clone https://github.com/Loop3D/map2loop.git
cd map2loop
conda install gdal
conda install -c loop3d -c conda-forge --file dependencies.txt
pip install -e .
```
### Documentation
Map2loop's documentation is available <a href="https://loop3d.org/map2loop/">here</a>
## Usage
Our notebooks cover use cases in more detail, but here is an example of processing Loop's South Australia remote geospatial data in just 20 lines of Python.
First, let's import map2loop and define a bounding box. You can use GIS software to find one or use [Loop's Graphical User Interface](https://loop3d.github.io/downloads.html) for the best experience and complete toolset. Remember what projection your coordinates are in!
```python
from map2loop.project import Project
from map2loop.m2l_enums import VerboseLevel
# Note that this region is defined in the EPSG 28354 projection and
# x and y represent easting and northing respectively
bbox_3d = {
'minx': 250805.1529856466,
'miny': 6405084.328058686,
'maxx': 336682.921539395,
'maxy': 6458336.085975628,
'base': -3200,
'top': 1200
}
```
Then, specify: the state, directory for the output, the bounding box and projection from above - and hit go! That's it.
```python
proj = Project(use_australian_state_data = "SA",
working_projection = 'EPSG:28354',
bounding_box = bbox_3d,
loop_project_filename = "output.loop3d"
)
proj.run_all()
```
This is a minimal example and a small part of Loop.
Our _documentation and other resources outline how to extend map2loop and port to the LoopStructural modelling engine. We are working to incorporate geophysical tools and best provide visualisation and workflow consolidation in the GUI._
_Loop is led by Laurent Ailleres (Monash University) with a team of Work Package leaders from:_
- _Monash University: Roy Thomson, Lachlan Grose and Robin Armit_
- _University of Western Australia: Mark Jessell, Jeremie Giraud, Mark Lindsay and Guillaume Pirot_
- _Geological Survey of Canada: Boyan Brodaric and Eric de Kemp_
---
### Known Issues and FAQs
- Developing with docker on Windows means you won't have GPU passthrough and can’t use a discrete graphics card in the container even if you have one.
- If Jupyter links require a token or password, it may mean port 8888 is already in use. To fix, either make docker map to another port on the host ie -p 8889:8888 or stop any other instances on 8888.
### Links
[https://loop3d.github.io/](https://loop3d.github.io/)
[https://github.com/Loop3D/LoopStructural](https://github.com/Loop3D/LoopStructural)
Raw data
{
"_id": null,
"home_page": null,
"name": "map2loop",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.8",
"maintainer_email": null,
"keywords": "earth sciences, geology, 3-D modelling, structural geology, uncertainty",
"author": "Loop team",
"author_email": null,
"download_url": "https://files.pythonhosted.org/packages/c0/dc/fa110d2dfd0b70f75844cec6bb0176f5e7ad8b401785d0c21bdebe93e84e/map2loop-3.2.1.tar.gz",
"platform": null,
"description": "\n[](https://doi.org/10.5194/gmd-14-5063-2021)\n\n\n\n[](https://github.com/Loop3D/map2loop/actions/workflows/linting_and_testing.yml)\n[](https://github.com/Loop3D/map2loop/actions/workflows/documentation.yml)\n\n\n# Map2Loop 3.2\n\nGenerate 3D geological model inputs from geological maps \u2014 a high-level implementation and extension of the original map2loop code developed by Prof. Mark Jessell at UWA. To see an example interactive model built with map2loop and LoopStructural, follow this link:\n\n<a href=\"http://tectonique.net/models/brockman_syncline.html\">3D Model from the Hamersley region, Western Australia</a>\n\n## Install\n\n#### Option 1: Install with Anaconda\n\nThis is the simplest and recommended installation process, with:\n\n```bash\nconda install -c loop3d -c conda-forge map2loop\n```\n\n#### Option 2: Install with pip\nInstallation with pip will require that GDAL is installed on your system prior to map2loop installation. \nThis is because GDAL cannot be installed <a href='https://hackernoon.com/hn-images/1*m4cnTYJWM7Rmpsju8dSHmQ.jpeg'>via pip</a> (at least not with one line of code), and the GDAL installation process will vary depending on your OS. \n\nFor more information on installing gdal, see <a href=\"https://pypi.org/project/GDAL/\">GDAL's Pypi</a> page.\n\nOnce GDAL is available on your system, map2loop can be installed with:\n```bash\npip install map2loop\n```\n\n#### Option 3: From source\n\n```bash\ngit clone https://github.com/Loop3D/map2loop.git\n\ncd map2loop\n\nconda install gdal\n\nconda install -c loop3d -c conda-forge --file dependencies.txt\n\npip install .\n```\n\n#### Option 4: From source & developer mode:\n```bash\ngit clone https://github.com/Loop3D/map2loop.git\n\ncd map2loop\n\nconda install gdal\n\nconda install -c loop3d -c conda-forge --file dependencies.txt\n\npip install -e .\n```\n\n### Documentation\n\nMap2loop's documentation is available <a href=\"https://loop3d.org/map2loop/\">here</a>\n\n\n## Usage\n\nOur notebooks cover use cases in more detail, but here is an example of processing Loop's South Australia remote geospatial data in just 20 lines of Python.\n\nFirst, let's import map2loop and define a bounding box. You can use GIS software to find one or use [Loop's Graphical User Interface](https://loop3d.github.io/downloads.html) for the best experience and complete toolset. Remember what projection your coordinates are in!\n\n```python\nfrom map2loop.project import Project\nfrom map2loop.m2l_enums import VerboseLevel\n\n# Note that this region is defined in the EPSG 28354 projection and\n# x and y represent easting and northing respectively\nbbox_3d = {\n 'minx': 250805.1529856466,\n 'miny': 6405084.328058686,\n 'maxx': 336682.921539395,\n 'maxy': 6458336.085975628,\n 'base': -3200,\n 'top': 1200\n}\n```\n\nThen, specify: the state, directory for the output, the bounding box and projection from above - and hit go! That's it.\n\n```python\nproj = Project(use_australian_state_data = \"SA\",\n working_projection = 'EPSG:28354',\n bounding_box = bbox_3d,\n loop_project_filename = \"output.loop3d\"\n )\n\nproj.run_all()\n```\n\nThis is a minimal example and a small part of Loop.\n\nOur _documentation and other resources outline how to extend map2loop and port to the LoopStructural modelling engine. We are working to incorporate geophysical tools and best provide visualisation and workflow consolidation in the GUI._\n\n_Loop is led by Laurent Ailleres (Monash University) with a team of Work Package leaders from:_\n\n- _Monash University: Roy Thomson, Lachlan Grose and Robin Armit_\n- _University of Western Australia: Mark Jessell, Jeremie Giraud, Mark Lindsay and Guillaume Pirot_\n- _Geological Survey of Canada: Boyan Brodaric and Eric de Kemp_\n\n---\n\n### Known Issues and FAQs\n\n- Developing with docker on Windows means you won't have GPU passthrough and can\u2019t use a discrete graphics card in the container even if you have one.\n- If Jupyter links require a token or password, it may mean port 8888 is already in use. To fix, either make docker map to another port on the host ie -p 8889:8888 or stop any other instances on 8888.\n\n### Links\n\n[https://loop3d.github.io/](https://loop3d.github.io/)\n\n[https://github.com/Loop3D/LoopStructural](https://github.com/Loop3D/LoopStructural)\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "Generate 3D model data from 2D maps.",
"version": "3.2.1",
"project_urls": {
"Bug Tracker": "https://github.com/Loop3D/map2loop/issues",
"Documentation": "https://Loop3d.org/map2loop/",
"Source Code": "https://github.com/Loop3D/map2loop"
},
"split_keywords": [
"earth sciences",
" geology",
" 3-d modelling",
" structural geology",
" uncertainty"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "c0dcfa110d2dfd0b70f75844cec6bb0176f5e7ad8b401785d0c21bdebe93e84e",
"md5": "3838e7b119826908b34f1e78aea56d04",
"sha256": "e817fe1591765e3a10d8e7a16c0f7f41a6c1ef387f19093a0e89f2c188b797aa"
},
"downloads": -1,
"filename": "map2loop-3.2.1.tar.gz",
"has_sig": false,
"md5_digest": "3838e7b119826908b34f1e78aea56d04",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.8",
"size": 333680,
"upload_time": "2025-01-13T00:00:35",
"upload_time_iso_8601": "2025-01-13T00:00:35.432469Z",
"url": "https://files.pythonhosted.org/packages/c0/dc/fa110d2dfd0b70f75844cec6bb0176f5e7ad8b401785d0c21bdebe93e84e/map2loop-3.2.1.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-01-13 00:00:35",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "Loop3D",
"github_project": "map2loop",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "map2loop"
}
JSON
