This page is currently under construction. It will provide bare-bones instructions for pre-alpha testers.
Software Programmer: Tony Bernardin
Crusta data on nile has been moved to here
Before installing Crusta you need to download and install the following programs (links for Mac OS X):
1. GDAL - website
2. CMAKE - click to download
3. GIT - website
4. XQuartz (Mac OS X Only) - website
This installation assumes you have installed Vrui-3.0 to ~/Vrui-3.0 or in more detail /Users/yourusername/Vrui-1.0 – Check this by typing cd ~/Vrui-3.0 - If it is there, all steps in this manual will apply, if not then you will have to edit one command in a future step.
Instructions on how to install Vrui can be found here
Step 1 Choose a directory where you want to install the Crusta folder - I suggest doing this in ~/src
Step 2 Type:
git clone git://github.com/KeckCAVES/crusta.git
Step 3 Move into the new crusta folder
Step 4 Type (Enter between each line)
Step 5 Create a make file. If you have not installed Vrui-3.0 to ~/Vrui-3.0 you will need to change the -DVRUI_PATH=~/Vrui-3.0 command to the directory where Vrui is installed. Please note the trailing two dots as they are part of the command line.
cmake -DCMAKE_BUILD_TYPE=Release -DCMAKE_INSTALL_PREFIX=~/Crusta -DVRUI_PATH=~/Vrui-3.0 ..
For computers in iMAC classroom
cmake -DCMAKE_BUILD_TYPE=Release -DCMAKE_INSTALL_PREFIX=~/Crusta -DVRUI_PATH=/Vrui-3.0 ..
Step 6 Make
make -j(# of processors you would like to use)
Do not use -j if you are unsure of what it means
Step 7 Make Install
Step 8 Go to folder with programs
Step 9 Test installation
crusta should pop up
Step 10 Setup Crusta .cfg files (For version 10.03.03 go here) Crusta is configurable through a set of separate files. Some have been provided through the git repository and are in the subfolder ~/src/Crusta/share. Some are copied during installation to the ~/Crusta/share/crusta:
Once you have the git clone of the sources, fetching the latest updates is very quick and easy:
Step 1 Use the terminal to navigate to the Crusta folder. In our example:
Step 2 Use git to fetch the latest source updates:
Step 3 Navigate to the release build folder and rebuild the executable:
You now have the latest Crusta release.
Follow these steps to start Crusta.
Open a Terminal window.
cd into the directory that contains the program crusta:
and then launch:
./crusta -dem /path/to/dem -color /path/to/color
If you'd like to use the default configuration of the Crusta tools for desktop use you can merge this configuration at start-up by adding '-mergeConfig path/to/pre.cfg' to the command line. In the example below we have copied pre.cfg to the installed share location ~/Crusta/share/crusta:
./crusta -dem /location/of/dem -color /location/of/color -mergeConfig share/crusta/pre.cfg
If you are always going to be using the configuration you may also copy the pre.cfg file to the folder containing the crusta executable (~/Crusta) and rename it to Vrui.cfg. This way it will automatically be loaded.
Similarly the default crusta settings can be merged in on the command line by appending:
To minimize the chances of accidentally forgetting to import the proper settings, please copy the crustaSettings.cfg file provided in the source distribution (~/src/Crusta/share/crustaSettings.cfg) to the folder containing the executable (~/Crusta/bin). When the settings file is present in the working directory crusta will automatically load it.
Example: If I had crusta in ~/Crusta/bin and the data files were in ~/Data/DEM/ and ~/Data/Color, I would use the following commands in terminal
./crusta -dem ~/Data/DEM/mainDEM -color ~/Data/Color/blueEye100113
Note although the Color and DEM folders contain numerous files with different numbers, I only need to call the first part of the file before the _#'s.
Note: You may not need to do this. When crusta launches, press the 1 button. If a menu pops up that allows you to toggle the texture image, you should not need to do the reset.
Once crusta has started the first thing to do is click the left mouse button in the red box and then the right mouse button in the red box. This resets both controls for those buttons.
Now, right click the mouse button and scroll to Navigation –> Surface-Alligned Navigation –> Mouse (Multiple Buttons)
BEFORE letting go click the left mouse button and then scroll the wheel on the mouse, then let go.
This assigns the left mouse button to pan, the scroll wheel to zoom, and the right mouse button to “grab” the data and rotate the frame around. At first, you will likely have to use the right mouse button to get the world into its correct orientation.
After playing with this for awhile you should be able to figure out the controls. Feel free to explore the data.
Because we reset the right click on the mouse, the Crusta menu does not have a button assigned to it. To assign this button, press a number down on the keyboard (e.g. 1) and then scroll to User-interface –> Menu Handler –> Screen-alligned Menu and then let go of the number (e.g. 1) - Do NOT click the mouse.
If done correctly, you can bring the menu up by pressing the # you assigned to the menu. Within this menu you can change the vertical scale. Due to the way the mouse was set-up in the beginning, you need to right click to move the vertical scale box around and change the scale.
If you have the menu assigned to button “1”, then press 1 and deselect textured terrain.
If you do not have the menu assigned by default, use whatever key you've assigned it to, or see “Setting up controls” above.
VRUI easily lets you save and restore viewpoints within any program (LidarViewer/Crusta). With the .cfg we are using, you will need to press button “1” and navigate to Vrui System –> View –> Save View and VRUI will export a file (If it's your first it will be called SavedViewpoint0001.view) into the directory where you ran crusta from (most likely ~/Crusta/bin). You can rename this file, but be sure to leave the .view ending. To load this view back, press button “1” and go to Vrui System –> View –> Load View and find the view you would like to load when the dialog box opens. Because of the way the controls are set up, controls in the dialog box are controlled by the right-mouse button.
Prepare yourself: (see here for release 10.03.03 instructions)
Tie cursor to Crusta surface
Set up mapping tool:
Using the mapping tool: You should now have these functions (WARNING: NO UNDO FUNCTIONALITY!):
Saving mapping to various file formats
Assigning attributes (this allows you to decorate lines in Arc with map symbols)
From the Crusta menu “Texturing modes” chose:
Chose “Palette Editor” from the crusta menu to open the editor. The editor shows three workspaces from top to bottom: 1. the color map, where individual control points with color attributes can be set and modified; 2. information and color picking panel; 3. control point and palette controls.
To select the elevation range to which the color map should be applied use the “Elevation Range Tool” as follows.
Assign the tool to an unassigned button. We will use #4 in the following.
Manipulate the range using the controls on the settings window:
Setting the minimum and the maximum directly on the terrain:
Sliding the range directly on the terrain:
Save and load ranges by using the corresponding buttons at the bottom of the window. Elevation ranges are saved as numbered files “Crusta_ElevationRangeXXXX.rng” where XXXX is a sequence number.
Since the opacity of the applied color can be controlled, contour lines can be generated by carefully editing a color map that is mostly transparent but contains opaque pixels. For example setting the left and right control points to fully opaque black, then creating two new adjacent transparent control points will produce one line at the boundary of the range (the color map is repeated in periods corresponding to the elevation range). Now using the “Shift Min” mode of the “Elevation Range Tool” will dynamically move the contour line to the terrain location pointed to by the cursor.
Use this tool to measure distances on the terrain. The approach is similar to the mapping tool above, so please read that first if you are not familiar with this
The Crusta PreProcessor (construo) processes both DEMs (topographic data) and imagery (Satellite, Aerial, etc - basically anything with 3 bands). The processor accept numerous types of data (.tif, .adf, etc) - A detailed list of acceptable formats is coming.
For a printout of how construo works, you can simply type:
Usage: construo -dem | -color <database name> [-scale <scalar>] [-nodata <value>] [-pointsampling] [-areasampling] <input files>
IMPORTANT - Creating a Crusta project is like painting. At first you need to paint a base layer and then layer other paint on top that improves the painting. Thus, when processing a Crusta project with different resolution data - the input file order is important. First call the lowest resolution data and then the medium then the highest resolution (e.g. Blue Marble –> Aster –> LiDAR).
Step 1. You will need:
Step 2. Open ArcScene
Step 3. Rename the output shapefile to Crusta_Polylines.shp Step 4. Start Crusta
All gdal supported formats.