Outcrop Vr

by kevinforrestconnors

see geologic outcrops in virtual reality

( Crawled 15 hours ago )
+

OutcropVR

Introduction

OutcropVR is a toolkit for geologists. One aspect of OutcropVR is of building a scene to view in VR. OutcropVR supports creation of real-world landscape data from coordinates or georeferenced models, as well as localization from UTM values.

The other aspect is the "game" mode tools. You can fly around your favorite outcrops and get unique angles that are impossible or difficult to see in real life. With the laser pointer tool, you can create lines and planes that then display the trend/plunge or strike/dip.

Installation and Setup

  1. Install Python 3 and pip.

  2. pip install numpy && pip install scipy && pip install utm

  3. Place OutcropVR.unitypackage somewhere you can find it. Open Unity and select Assets/Import Package/Custom Package... and browse to import the package.

  4. Find the line within Editor/MakeLandscape.cs that says FileName="C:/Program Files/Python36/python.exe" and change the string to your python 3 path. Repeat for files Editor/ConvertPhotogrammetryModel.cs and Editor/LandscapePhotogrammetryModel.cs.

Usage

The general workflow is:

  1. Import files
  2. Use the Tools menu to localize your models and create landscapes (if desired)
  3. That's it! Hit play and strap on your Vive gear.

Tools/Make Elevation Model from Range

Use the Unity menu to select Tools/Make Elevation Model from Range. This function produces a digital elevation map of an area specified with coordinates. Note that too large of a range (more than a degree or so) or too small (a hundreth of a degree or so) will result in an error.

Tools/Localize Photogrammetry Model from UTM

Use the Unity menu to select Tools/Localize Photogrammetry Model from UTM. This function takes in a photogrammetry .obj file that is in UTM coordinates, and converts it into smaller numbers so that Unity can work with it. If a texture file is supplied as well, it will be mapped onto the object.

Supported texture formats: .psd, .tiff, .jpg, .tga, .png, .gif, .bmp, .iff, .pict.

Tools/Make Elevation Model Around Photogrammetry Model

Use the Unity menu to select Tools/Make Elevation Model Around Photogrammetry Model. This function takes in a photogrammetry .obj file that is in UTM coordinates, converts it to smaller numbers so that Unity can handle it, and models a landscape around the centroid of the photogrammetry model. An unconverted UTM file is mandatory because finding the centroid requires the original georeferenced data. If a texture file is supplied as well, it will be mapped onto the object.

Supported texture formats: .psd, .tiff, .jpg, .tga, .png, .gif, .bmp, .iff, .pict.

Troubleshooting Tools/

My Texture Looks Malformmed

If you have two or more textures, this can happen. Since we don't know which Meshparts have which texture, this can't be automated. To fix this, manually inspect each Meshpart and under Mesh Renderer/Materials, change the size to allow for multiple textures, then put the materials in place. I have found that the second texture should be the second element, etc.

Troubleshooting OutcropVR

Currently, Make Plane is not working as intended at certain angles.

Planned Features

  • A compass that shows north, as a GUI item.
  • Making surfaces with the laser pointer