Getting Started With VrOne
VrPoint (LiDAR / Point Cloud) Entity “Get the job, do it right, get it out on time, make a profit. That’s what every mapping company is about!” - Jeff Crenshaw Northern Division Manager North American Mapping
VrOne is a powerful photogrammetric vector collection and editing package with image display capability. Photogrammetry today requires the mapping professional to deliver vector, image and digital terrain model (DTM) data as digital products. VrOne addresses many of the problems encountered in handling the collection, editing, and plotting of vector, image, and DTM data. Map updating and revision may also be performed with VrOne. Features
Input sources
Vector database
Image handling
Digital Terrain Modeling (DTM)
Plot Formats
“Rule of thumb; if you think something is clever and sophisticated, beware – it is probably self indulgence.” - Donald A. Norman, 1990
VrOne can be downloaded from the VrOne web page. Go to the home page, press the Download button, enter your username and password, and navigate to the desired folder.
There are two forms of VrOne installation:
Full Installation The full installation is always done from an executable program. This program may be downloaded from the VrOne web page or may be delivered via CD.
The name of the executable is as follows:
vr-MA_MI_BU.exe
Where: MA - Major version number MI - Minor version number BU - Build number
Example:
vr-05_01_05.exe would be Vr Mapping version 05.01.05
Once the file has been downloaded, run this program and follow the prompts to complete installation. Patch Installation Patch installations are partial installations designed to update certain programs and/or data. A full installation must be completed before patches can be applied. Patches are downloaded and installed in the same manner as full installations. VrOne Folder Structure Following is the default VrOne folder structure: C:\vr The VrOne base folder. It may be necessary to place VrOne on another drive such as D: or E:. If possible, the default folder of vr should be used. C:\vr\bin VrOne executables folder. Contains all Vr Mapping Software programs. C:\vr\data Contains VrOne data files, such as:
NOTE: These files are re-installed each full installation. However, if these files are modified, it is recommended they be moved to another folder or renamed. C:\vr\hostdir Contains run-time parameter files. It is delivered empty. Parameter files are created as needed by VrOne. Running VrOne After installation, links to the Vr Mapping programs are placed in a folder called Vr Mapping and this folder is placed on the desktop. VrOne can be run by double clicking the VrOne icon or by typing vrone from a command prompt window. Release Notes Each full installation of VrOne will have a corresponding Release Notes file that will document recent changes and additions to VrOne and it’s support files and programs. “Nothing is happening, there are no lights and everything is quiet… Oops, it’s unplugged.” - A hardware support call, 1981 Before starting VrOne for the first time, the VrOne configuration program should be run to set the proper input devices and parameter files. This is not a requirement and the configuration defaults allow VrOne to start the first time.
VrOne will start by opening the Main Window and one Graphics Window.
VrOne's main and graphics windows
If the current input device is the mouse, moving the mouse across the Graphics Window should show a cursor. The coordinates in the main window should change. Pulling down the File menu and selecting "Open Vr File" will open a VrOne file. Starting an Application (Command) Select an item from a dropdown menu to start commands. Alternatively, commands may be started from a key-in using the command name. Each command name is the first three letters of the first two words on the pull down. For example: The command name for Insert line is InsLin. If this rule is not followed the key-in is listed after the command in parentheses. For example: Zoom all (zooa). The Main Window VrOne's main window
The Main Window in VrOne contains the command pull down menus, a key-in area, two information areas, the application (command) stack, a progress bar, and the coordinate display.
Command names may be typed into the key-in area at almost any time. The mouse must be in the Main or Graphics window for keystrokes to be entered in the key-in area.
The active workspace and the number of currently opened workspaces is shown on the border of the Main Window. The Graphics Window VrOne's graphics window
The VrOne graphics window displays vectors and images. In Windows XP and Windows 7 there may be up to 8 windows open at a time. At the top of the window is displayed the window number, the scale of the window, the number of VrOne files opened and the number of images open. Also displayed is the image pyramid scale (i.e. 1:3.10) and the first two image names.
In the lower right corner of the graphics window is a push button that allows setting display of images, image names and image edges. The Menu Keys Dialog
The Menu Keys Dialog window is displayed by most interactive commands. At the top of the window is the command name. The next area displays the entity parameters. This information is command dependent and normally shows where the data is to be stored on insert commands or where the data came from on edit commands.
The third area is the menu keys area. These show what functions are assigned to the 12 menu key buttons. These keys are normally mapped onto an input device such as the keypad on a digitizing tablet cursor. They are also mapped onto the 12 function keys on a standard keyboard. Commands
“Everything should be as simple as possible... But no simpler.” - Albert Einstein
VrOne is a mapping system. It is normally used as the first step in map data collection. Although it may be used to edit vector data and generate DTM, the VrOne database will normally be translated to another system for final processing. These other systems include ARC-INFO, AutoCAD, and MicroStation.
It is important that the original database is simple enough to make moving the data easy. The VrOne database is an entity-based non-topological structure. Although the database contains some non-graphic and extended information other CADD systems do not, it cannot be considered a true Geographic Information System (GIS). It can however, prepare vector data for accurate translation to GIS and other CADD systems.
The VrOne database is a single file with all vector information contained in the one file. Support files include the symbol library and pen table (if specified). The size of the file is operating system dependent.
NOTE: The VrOne database is considered proprietary information to Cardinal Systems, LLC and is here for informational purposes for Vr Mapping uses. Copyright © 2000-2011 by Cardinal Systems, LLC. Each VrOne entity contains the following information:
Layering is a method of logically grouping graphic data. Buildings, roads and trees will probably occupy different layers. Range: 1 to10,001
Mode Defines the entity type as follows:
Arcs in VrOne are embedded in a line and contain arc flags to identify the start, mid-point, and end of each arc. Range: 1 to 5 Graphic Pointer The graphic pointer represents the display characteristics of an entity. A line will have a graphic pointer that might define it as a fence, tree or water line. A symbol will have a graphic pointer that might define it as a circle, cross or highway symbol. Range: 1 to 1000 Non-graphic Pointer May be used to define a pointer to non-graphic data. Currently unimplemented, although it can be set by the user. Range: -2 billion to 2 billion Pen Number Defines the color of the entity. Range: 1 to 256 Link Currently unimplemented, although it can be set by the user. In the future, it can link entities together or represent entity ownership. For example: This sidewalk and fence belong to this house. Range: -2 billion to 2 billion Construction Flag Line entities may be flagged as construction, which allows them to be turned off. This line description might be applied to hidden lines, reference lines, or other non-topological lines. Range: 0 to 1 Feature Code A user-defined 48-character non-graphic alphanumeric field for further entity classification. Range: 48 characters All lines in VrOne are three-dimensional. The number of points per line is unlimited (within the range of physical memory in the computer). Each line contains an entity header and the following information for each line point. X Y Z Each line point is represented by a double precision, three-dimensional coordinate. Range: -1.8e307 to 1.8e307 Width Represents the width of the line. This number defines the number of line strokes to place on each side of the centerline. The distance between the strokes is user-defined. Range: 1 to 256 Pen Code Defines the pen up/down status to the current point as follows:
This allows a line to appear broken graphically but remain contiguous in the VrOne database. Range: 1 to 4 Arc Flag Defines the arc status of the current point as follows:
Range: 1 to 3 Code Commonly used to define cross section codes such as top of bank, bottom of bank and edge of road. Cross sectioning has been largely replaced by DTM over the last several years and VrOne does not support cross sectioning. Range: 0 to 255 Flag System defined bit encoded flags. This field is not user definable. Range: 0 to 255 Each symbol entity contains an entity header and the following information: X Y Z Double precision three-dimensional coordinate. Range: -1.8e307 to 1.8e307 Radius Symbol radius in ground units. Range: -1.8e307 to 1.8e307 Rotation Symbol rotation expressed counterclockwise from the X-axis in decimal radians. Range: 0 – 2 * p. This value will be entered and displayed by VrOne as decimal degrees with a range of 0 to 360. Each text entity in VrOne may contain up to 512 characters. Each text entity contains an entity header and the following information: X Y Z Double precision three-dimensional coordinate. Range: -1.8e307 to 1.8e307 Justification X Text justification along the X-axis
Range: 1 to 4
Justification Y Text justification along the Y-axis
Range: 1 to 3 Font Number Text font to be used when drawing text.
Height Text height in ground units. Range: -1.8e307 to 1.8e307 Width Width of one text character in ground units. Range: -1.8e307 to 1.8e307 Rotation Text rotation expressed counterclockwise from the X-axis in decimal radians. Range: 0 – 2 * π. This value will be entered and displayed by VrOne as decimal degrees with a range of 0 to 360. Slant Text slant. Example: This text is slanted Range: 0 – π. This value will be entered and displayed by VrOne as decimal degrees with a range of 0 to 180. VrPoint (LiDAR / DSM / point cloud) Entity Information Each VrPoint entity in the VrOne database contains XYZ coordinates and up to 16 attributes per point . The definition of point attribute data is dependent on the input system and format. Even though available in the Vr Mapping database, all attributes may not be defined in the LiDAR data input. The Vr Point structure is based on the ASPRS LAS Specification Version 1.2 and ASPRS LAS Specification Version 1.4. Please see LAS In or LAS Out or LAS 1.2 and LAS 1.4 for more information about the LAS format and Vr Mapping's implementation.
Each point entity contains an entity header and the following information: X Y Z Double precision three-dimensional coordinate. Range: -1.8e307 to 1.8e307 Layer Vr Layer number. This attribute is not defined in the LAS specification. Range: 0-30001 Intensity The intensity value is the integer representation of the pulse return magnitude. This value is optional and system specific. Range: 0-65535 Display Flag Flag to indicate if the point should be displayed. This attribute is not defined in the LAS specification. Range: 0=No 1=Yes Return Number The Return Number is the pulse return number for a given output pulse. A given output laser pulse can have many returns, and they must be marked in sequence of return. The first return will have a Return Number of one, the second a Return Number of two, and so on up to five returns. LAS 1.2 - Range: 1-5 LAS 1.4 - Range: 1-15 Number of Returns The Number of Returns is the total number of returns for a given pulse. For example, a laser data point may be return two (Return Number) within a total number of five returns. LAS 1.2 - Range: 1-5 LAS 1.4 - Range: 1-15 Scan Direction The Scan Direction Flag denotes the direction at which the scanner mirror was traveling at the time of the output pulse. A bit value of 1 is a positive scan direction, and a bit value of 0 is a negative scan direction (where positive scan direction is a scan moving from the left side of the in-track direction to the right side and negative the opposite). Range: 0-1 Edge Flag The Edge of Flight Line data bit has a value of 1 only when the point is at the end of a scan. It is the last point on a given scan line before it changes direction. Range: 0-1, 1=Point is edge of flight line Classification Point Classification. If a point has never been classified, this value must be set to zero. LAS 1.2 - Range: 0-31
LAS 1.4 - Range: 0-255
Synthetic Flag If set to 1, then this point was created by a technique other than LiDAR collection such as digitized from a photogrammetric stereo model. Range: 0-1 Key Point Flag If set to 1, this point is considered to be a model key-point and thus generally should not be withheld in a thinning algorithm. Range: 0-1 Delete Flag If set to 1, this point should not be included in processing (synonymous with Withheld). Range: 0-1 Overlap If set, this point is within the overlap region of two or more swaths or takes. LAS 1.2 - Not defined LAS 1.4 - Range: 0-1 Scan Angle LAS 1.2 - The Scan Angle has a valid range from -90 to +90 and is the angle (rounded to the nearest integer in the absolute value sense) at which the laser point was output from the laser system including the roll of the aircraft. The scan angle is within 1 degree of accuracy from +90 to –90 degrees. The scan angle is an angle based on 0 degrees being nadir, and –90 degrees to the left side of the aircraft in the direction of flight. Range: +90 to -90
LAS 1.4: The Scan Angle is a value that represents the rotational position of the emitted laser pulse which respect to the coordinate system of the data. Down in the data coordinate system is the zero position. Each increment represents 0.006 degrees. Counterclockwise rotation, as viewed from the rear of the sensor, facing in the along-track (positive trajectory) direction, is positive. The maximum value in the positive sense is 30,000 (180 degrees) Range: -32000 to 32000 Flight Number User-defined flight numbed. This attribute is not defined in the LAS specification. Range: 0-255 Point Source ID This value indicates the file from which this point originated. Valid values for this field are 1 to 65,535 inclusive with zero being used for a special case discussed below. The numerical value corresponds to the File Source ID from which this point originated. Zero is reserved as a convenience to system implementers. A Point Source ID of zero implies that this point originated in this file. This implies that processing software should set the Point Source ID equal to the File Source ID of the file containing this point at some time during processing. Range: 0-65535 Sensor (Scanner Channel) The Scanner Channel is used to indicate the channel, or scanner head of a multi-channel system. Channel 0 is used for single channel systems. LAS 1.2: Not defined LAS 1.4: Range 0-3 NIR Near Infrared Channel. This attribute is available in VrPoint (LAS) format 8. LAS 1.2: Not defined LAS 1.4: 0-65535 GPS Time GPS time at which the point was acquired in seconds. This attribute is available in VrPoint (LAS) formats 1, 3, 6, 7, and 8. Range: -1.8e307 to 1.8e307 Red The Red image channel value associated with this point. This attribute is available in VrPoint (LAS) formats 2, 3, 7, and 8. LAS Range: 0-65535 Vr Range: 0-255 Green The Green image channel value associated with this point. This attribute is available in VrPoint (LAS) formats 2, 3, 7, and 8. LAS Range: 0-65535 Vr Range: 0-255 Blue The Blue image channel value associated with this point. This attribute is available in VrPoint (LAS) formats 2, 3, 7, and 8. LAS Range: 0-65535 Vr Range: 0-255 For more information on the supported LAS formats please see:
Overview of Changes in 1.4 from 1.2 Following is an overview of the changes from LAS 1.2 to LAS 1.4. This list does not include all the differences. Please see the LAS format specifications for more details.
Supported Point Data Records LAS 1.4 supports waveform data, however the Vr Mapping LAS translators does not support this data so the LAS Point Data Record formats 4, 5, 9 and 10 are not supported. LAS 1.4 consists of 11 Point Data Record formats. Formats 0-3 are legacy formats from version 1.2 which are still supported and formats 6-8 are defined in the 1.4 specification. For more details on each of the supported point formats, please see the LAS format specifications in the LAS documentation listed above. Following are the record formats supported by Vr Mapping.
Additions and Modifications to the LAS Specification
“Hay don’t you remember, you called me Al…” - Song from the depression era VrOne commands are the heart of the system. While these commands are available from the pull-down menus in VrOne they are also available as key-ins. Key-in commands may be entered real-time or may be placed in macros and placed in function keys. See List of Commands for a list of the VrOne commands. “The art of mapping is the art of organizing complexity.” - Anonymous Function Keys are the most important aspect of VrOne data collection. Taking the time to properly set up function keys before a project has started will save hundreds of hours of production time.
Function keys are the means of giving Vr Mapping (which internally is structured like a CADD system) a mapping system interface. This simplifies operations for mapping professionals by reducing the apparent complexity. For example, instead of using the CADD operation Insert Line (InsLin) to place a road, the operator could use a Function Key such as “Paved Road” which will assign the user definable parameters, attributes and behavior to Insert Line and start it. Function Keys are fully customizable, and-if the need arises-the full flexibility of the CADD operations is always available.
In practice, the mapping professional simply chooses the feature they want to collect and starts collecting data.
Entering its name or function key number may start a Function Key. These names or numbers may be keyed-in, placed in macros or even placed in other function keys.
The name of the Function Key file to use must be set in the VrOne configuration program (VrCfig). It is possible to have multiple function key files but only one can be active at a time. Creating and Editing Function Keys The Edit Function Key (EdiFun) dialog box
In the above dialog box a function key called Building is being created. The line that is placed by this function key will be a squared, un-fonted white line placed in layer 19. Function Keys Lists the currently defined function keys. A key may be selected and its parameters will be displayed to the right. Key name This is the name of the function key and may be used to start the function key. This name may be keyed in, placed in a macro or on another function key. Key num Function keys may also be numbered. This number may be entered to start the function key. This is useful when a menu board is not available and function keys must be started from the system keyboard. Vr function Defines the VrOne application to start when the key is executed. The proper Line, Symbol or Text tab will be selected depending on the type of VrOne command selected. Desc This is the function key description and is for information only. Line Tab Line parameters that will be assigned when the function key is executed. Symbol Tab Symbol parameters that will be assigned when the function key is executed. Text Tab Text parameters that will be assigned when the function key is executed. Local Arguments These commands will be executed when the function key is started. Normally local commands are placed here. For example, if the Insert Symbol command is started by a key and the symbol rotation needs to be turned on then ROTMODE=1 would be entered on the Arguments line. Multiple commands may be entered separated by a comma. Global Arguments These commands will be executed when the function key is started and when the function key is woken up after being overlaid. Normally global commands are place here. (See the On End Example)
For example, consider the state of a global command such as snap:
Placing SnaEnd in the Wake up command of Contour ensures the state of this global parameter is what is expected. Assoc cmd Associate commands allow function keys to be linked. In many cases there may be several function keys used to insert a certain map feature. One might put in a line and another may put in text.
For example, consider the operation of inserting a parking area. This feature consists of line that will define the parking edge and a text label of “Parking Area”. There are two function keys defined which are ParkLine and ParkText. The associate command 1 of ParkLine has be set to ParkText as follows:
On end cmd The on end command allows one function key to execute a key-in, a macro or another function key each time an entity is saved. (See the On End Example)
For example, consider a spot elevation. This feature consists of a symbol and a text label. There are two function keys defined as follows: SpotX Places the spot elevation X. SpotElev Places the elevation of the previously read symbol.
The On end command of SpotElev is set as follows:
When the spot elevation symbol is placed, the On End command will start Spot Text.
The On end command of SpotText is set as follows:
The Pop command tells VrOne to terminate the current application (command) that is at the top of the application stack.
There are more parameters that would need to be set to make the spot elevation functions keys work as expected but the above example shows how to chain function keys together. On quit cmd The on quit command will be executed when the function key application ends. This field may consist of key-ins, macros or other function keys. On quit commands are commonly used to set global parameters to a know state when an application ends. For example, if a function key was snapping to existing entities to obtain elevations, the on quit command may be used to turn snapping off. “Become proficient in another language – or at least get the tapes and try.” - Richard A. Moran Macros give the ability to execute a group of VrOne commands as a single word. Macros can execute VrOne commands, function keys and other macros. It is common to use macros to condition snap parameters; they is useful for turning groups of layers on and off. In the following example, a macro called “R” toggles stereo roaming with the Toggle Roaming (TogRoa) command.
The Edit Macro dialog box
It is possible to have a macro start an application (command) such as Insert Line and then condition the local parameters, but Function Keys were designed to do this.
|