ArcView^® 3D Analyst^TM Version 1.0 Installation Instructions

Table of Contents

ArcView GIS Version 3.0b

ArcView GIS Version 3.0a users:  The ArcView GIS Version 3.0b patch is available to download from the Environmental Systems Research Institute, Inc. (ESRI) web page at www.esri.com. Search the home page for "Downloads".  Media can be obtained by calling ESRI Customer Service at 909-793-2853, extension 1670.

ArcView GIS Version 3.0 users:  To upgrade directly from 3.0 to 3.0b, the ArcView GIS Version 3.0b upgrade media can be obtained by calling ESRI Customer Service at 909-793-2853, extension 1670.

To determine which version of ArcView you are currently using, click on the About ArcView option under the Help menu.

Back to TOC

What is ArcView 3D Analyst Version 1.0?

With ArcView 3D Analyst you can

• Create TIN and GRID based surface models.
• Perform analysis on surfaces such as profiling, contouring, and visibility.
• Work with new shape types to represent simple 3-D geometry.
• View your data using real-time 3-D graphics.

System requirements for ArcView GIS Version 3.0b and ArcView 3D Analyst Version 1.0

The following chart provides information about the system requirements for installing and using ArcView GIS and ArcView 3D Analyst on UNIX^® computers.
 

Platform	Operating System	Window Manager	OpenGL	Memory*	Swap Space*
DigitalTM UNIX	Digital UNIX v4.0	CDE or Motif®	Open3D v4.x	64 MB	75 MB
HP® 9000/700	HP-UX® 10.20 ACE (700 series, 8x7 series)	CDE or HP VUE®	v 1.1	32 MB	100 MB
IBM® RS/6000TM	AIX® 4.1.4 (RTE - supplied by ESRI)	CDE or AIX Windows® Rev. 4.1.4.0	v 4.1.5.0	32 MB	64 MB
SGI®	IRIXTM 6.2, with patches SG0001717, SG0002086, SG0002161, SG0002044, and 6.2_POSIX set.**	6.2 (based on OSF/Motif® 1.2.4)	Built into IRIX 6.2	64 MB	100 MB
SunTM SolarisTM 2.x	Solaris 2.5 (SunOSTM 5.5)	CDE or OpenWindowsTM	v 1.1	32 MB	100 MB

Notes:  * Memory and swap space are based on a single user.
            ** These patches can be obtained from SGI's Web site www.sgi.com or FTP site ftp.sgi.com.

Required: ArcView 3D Analyst requires Operating System level OpenGL software libraries.  These must be installed and configured properly prior to loading the 3D Analyst extension in ArcView.

Recommended: OpenGL accelerated graphics card with geometry co-processor and hardware texture mapping. Refer to the section on Improving Graphics Performance for more information.
 
To determine if your machine has OpenGL installed, type one of the following for your installation platform:

Digital UNIX
% setld -i | grep OpenGL

HP 9000/700
% swlist | grep OpenGL

IBM RS/6000
% lslpp -l | grep OpenGL

SGI
Part of the operating system (IRIX 6.2).

Solaris 2.x
% pkginfo | grep OpenGL

Note: These commands will list the OpenGL software if it is installed, but they don't guarantee proper configuration.

Back to TOC 

Installing ArcView 3D Analyst Version 1.0

Note: Be sure you are installing the correct version of ArcView 3D Analyst with the correct version of ArcView. The following steps describe how to install ArcView 3D Analyst Version 1.0 for ArcView GIS Version 3.0b.

1. Insert the ArcView 3D Analyst Version 1.0 CD in your CD-ROM drive.

2. Become root user (excluding Solaris 2.x, and IRIX 6.x):

% su

You will be prompted for your root user password. If you do not know this password, contact your system administrator.

3. If a cdrom directory does not exist, create it using the following command:

# mkdir /cdrom

4. To mount the ArcView 3D Analyst CD, use one of the following for your installation platform (where <dev> stands for the CD-ROM device):

Digital UNIX           mount -t cdfs -r -o nodefperm,rrip /<dev> /cdrom
HP 9000/700            mount -F cdfs -r /<dev> /cdrom (or use sam)
IBM RS/6000          mount -v 'cdrfs' -p'' -r'' /<dev> /cdrom (or use smit)
SGI                            IRIX 6.x automatically mounts the CD as /CDROM
Solaris 2.x                Includes the Volume Management^TM software that automatically
                                    mounts the CD, providing immediate access to your CD-ROM

5. Once the ArcView 3D Analyst CD is mounted, exit root user mode:

# exit

6. The "install" command has five options from which to select:
Usage: install <-help | -load | -remove | -verify | -lmhostid>.

Use the  "-help" option to read more about the installation procedure.

7. Before starting the ArcView 3D Analyst CD installation for your platform, go to where your arcview3 directory is located:

% cd $AVHOME
% cd ..

Note: You will need to have write permission to your $AVHOME directory. For more information about the $AVHOME directory, please refer to the ArcView GIS Installation Guide (av30binstall.html) located in your $AVHOME/avdocs directory or on the ArcView GIS Version 3.0b CD.
 
8. To start the installation for the ArcView 3D Analyst and tutorial data, type one of the following for your installation platform:

Digital UNIX          /cdrom/3d10_30b/osf/install -load
HP 9000/700           /cdrom/3d10_30b/hpux/install -load
IBM RS/6000         /cdrom/3d10_30b/ibm/install -load
SGI                         /CDROM/3d10_30b/sgi/install -load
Solaris 2.x              /cdrom/cdrom0/3d10_30b/solaris/install -load

This starts the dialog for the menu-driven installation procedure. Default selections are noted in brackets [ ]. To obtain a list of options or on-line help, type "?" at any prompt. You can quit the installation procedure at any time by typing quit or "q". To return to a previous question, type a caret, "^".

Do not accept the default CD-ROM mount point when installing ArcView 3D Analyst, instead, the CD-ROM mount point should read as follows:

/cdrom/3d10_30b/<platform>
/cdrom/cdrom0/3d10_30b/solaris (Solaris 2.x only)
 
Note: The path name you specify as the ArcView 3D Analyst installation directory should be the same as the path for your arcview3 directory and can't contain any uppercase letters.

Back to TOC

Setting up your account

The HOME environment variable ($HOME) must be set to a directory that you have write access to.

2. Setting the LIBRARY PATH variable.

All platforms need to set the LIBRARY PATH to include the ArcView lib directory:

Digital UNIX
setenv LD_LIBRARY_PATH $AVHOME/lib:/usr/shlib

HP 9000/700
setenv SHLIB_PATH $AVHOME/lib

IBM RS/6000
setenv LIBPATH $AVHOME/lib:/usr/lib:/lib

SGI
setenv LD_LIBRARY_PATH $AVHOME/lib:/usr/lib

Solaris2
setenv LD_LIBRARY_PATH $AVHOME/lib:/usr/openwin/lib:/usr/ucblib
 
3. Then, at the command line prompt,

% source .cshrc

Back to TOC

ArcView license manager

% setenv AVHOME /<path_to_arcview3_install_directory>/arcview3

For more information about setting up the license manager, please refer to the ArcView GIS Installation Guide (av30binstall.html) located in your $AVHOME/avdocs directory or on the ArcView GIS Version 3.0b CD. For a detailed discussion of the license manager, refer to the License Manager's Guide included in your ArcView GIS package.

The license manager software is distributed with ArcView GIS. The files are located in the $AVHOME/sysgen directory.

• ESRI - the ArcView application daemon
• lmgrd - the license manager daemon
• sample.dat - a sample license file
• lmutil - the license manager executable
• adminlicense - a utility to edit and verify the license file

• lmdiag - diagnoses a problem when a license cannot be checked out
• lmdown - shuts down the license and application daemon
• lmhostid - returns the FLEXlm^® hostid of a workstation
• lmremove - removes specific licenses
• lmreread - informs the license daemon of changes in the license file
• lmstat - reports on the status of the daemons and the license uses

• convert - converts the old time-out dates (31-dec-99) in the license file to no time-out date (1-jan-00)
• verify - verifies the contents of the license.dat file
• help - displays help for the adminlicense utility

SERVER   siddhartha    5500439b   1700
DAEMON   ESRI   $AVHOME/sysgen/ESRI
FEATURE  ArcView3    ESRI 1.000   1-jan-00   200    B2EF061B26BCDC05F17D ""
FEATURE  AV3D1       ESRI 1.000   1-jan-00   200    ABCE90A16C1C3310DCFD ""

The first line identifies the name and FLEXlm hostid of the workstation (in this case, siddhartha) on your network that will be the server for the license manager (the node from which the license manager daemons will run).

The second line identifies the license daemon for ArcView and its location. The following lines, called feature lines, specify the features that are to be licensed (e.g., ArcView GIS Version 3.0x and ArcView 3D Analyst), the name of the daemon that manages the licenses (ESRI), the application daemon version (1.000), the time-out date for the feature (1-jan-00), the number of users (200), and a keycode for the feature.

To obtain the license file for your site

1. The hostname is obtained with the command:

% hostname

2. The FLEXlm hostid is obtained with the command:

% $AVHOME/sysgen/lmutil lmhostid

In the United States

2.  Mail, fax, or E-mail the completed form to Keycode Support.

Fax number: 909-335-1716
E-mail address: keycodes@esri.com

Outside the United States

Back to TOC

Installing the license file

% cd $AVHOME/sysgen
% ./adminlicense

Once you have updated the license.dat file with the new feature line, update the daemons.

% $AVHOME/sysgen/lmutil lmreread -c $AVHOME/sysgen/license.dat

Back to TOC

To start ArcView 3D Analyst

2. Open the Extensions Manager under the File menu, and load ArcView 3D Analyst.

3. Open a view.

When the extension is loaded, a 3D Scene document icon is added to the Project window, and a Surface menu is added to the View's existing menus.
 

Back to TOC 

ArcView 3D Analyst Help

3D shape classes, introduced to ArcView GIS Version 3.0b by this extension, include PointZ, MultiPointZ, LineZ, PolyLineZ, PolygonZ, RectZ, Vector, and MultiPatch. These shapes are supported in core ArcView GIS starting at Version 3.1. To find the listing of classes unique to ArcView 3D Analyst in the on-line help, click the help Contents tab, open the Extensions booklet, then the 3D Analyst booklet, then the Customizing the 3D Analyst with Avenue booklet.

Another great source is the Using the ArcView 3D Analyst book provided with the software.

Back to TOC

Improving Graphics Performance

A variety of OpenGL cards are available. Their capabilities and prices vary. Here are some issues to be aware of when making purchasing decisions:

• Level of support for OpenGL: some cards support only a partial implementation of the OpenGL API, handling few tasks in hardware. Look for cards that are designed and optimized for OpenGL to achieve the best performance.

• Geometry setup: reduces load on CPU and graphics pipeline by accepting semi-processed geometry data and arranging it in a format optimized for 3D rendering.

• Texture mapping: handles imagery in hardware. Images, such as those from satellites, orthophotos, and scanned maps, can be rendered in real time when texture mapping is supported in hardware on the card. Texture memory controls the total amount of imagery that can be used at one time. Maximum texture block size controls how large an individual image can be.

• Z buffer resolution: controls how accurately the card can perform hidden surface removal. The minimum to be considered is 16-bit, with the highest and most accurate resolution being 32-bit. The 3D Analyst requests a 24-bit Z buffer but will work with values both higher and lower.

• Output resolution, colors, and refresh rate: these control the size and quality of the resulting display on your monitor. The higher these properties  the better the display quality. Be aware that configuring a card to maximize one of its capabilities may diminish its capabilities in other areas. For example, just because a card supports a 24-bit color mode and 1280x1024 output resolution doesn't mean you can have them simultaneously. Also, depending on the card, increasing one of these parameters may impact memory available for other things such as textures.

• Here is a listing of the graphics cards by manufacturer that ESRI has used successfully* to improve rendering performance with the 3D Analyst:

Back to TOC

Design Limitations

• Compatible versions of 3D Analyst and Spatial Analyst are required when they're being used in the same ArcView installation. These are 3D Analyst version 1.0 and Spatial Analyst version 1.1. Combining versions other than these are not supported.

• Color flashing and ArcView/OpenGL display mis-matches can occur on 256 and lower color graphics display devices. Use a hi-color card and display mode.

• You can only paste 3D graphics from a view into a scene. 2D graphics will be ignored.

• Only simple symbols can be used for point, line, and polygon features in 3D scenes. Color and size are the only properties used for points. Color and width are the only properties used for lines. Color is the only property used for polygons. All other properties will be ignored.

• In ArcView GIS Version 3.0b, CAD based FThemes do not use z coordinates from the source data file in a 3D scene document. ArcView GIS Version 3.1 will support z coordinates of CAD based FThemes.

• Only FThemes, GThemes, IThemes, and SThemes are supported in a 3D scene. Other theme types, such as DBThemes and StreetMap themes cannot be used. They must first be converted to one of the supported types.

• The extension dialog will not let you unload the Dialog Designer if the 3D Analyst is also loaded. Unload the 3D Analyst first, then you can unload the Dialog Designer.

• The JPEG (JFIF) Image Support extension will be loaded automatically upon loading the 3D Analyst extension. It will be unloaded automatically when the 3D Analyst is unloaded unless it was loaded manually before the 3D Analyst. The JPEG extension cannot be unloaded while the 3D Analyst is loaded.

• You cannot use a VAT item from an integer grid to provide the base height for a grid theme.

Known issues and limitations

• On all UNIX platforms, ArcView GIS Version 3.0b can experience a fatal error when attempting to load the 3D Analyst and the machine being used does not have a proper OpenGL configuration. ArcView GIS will not fatal under these conditions at Version 3.1 but a recoverable error will be issued and the extension will not load as OpenGL is required.

• You may not be able to see any features if themes with very different, non-overlapping, extents are loaded and turned on simultaneously in a 3D scene. This holds true even when zooming to the extent of one of them. Turn on only one at a time and zoom to it.

• There is a limit of 10-16 different TINs which can be open at the same time in one ArcView session. The number varies depending on whether the TIN directory contains TMSK, TNVAL, and TTVAL files. Do not try to open more than 10 different TINs in the same project. You can have more than 10-16 TIN object variables if some of them reference the same TIN source that's stored on disk.

• In ArcView GIS Version 3.0b, the Make Default button on the Customize dialog will cause duplicate 3D Analyst menu and tool entries in the View document when ArcView is restarted. If you'd like the 3D Analyst to be loaded by default upon startup use the Make Default button on the Extensions dialog.

• When switching from a view or layout to a 3D scene and back again, the view or layout's active tool is lost. You must select the desired tool to make it active.

• Problems can occur when attempting to use viewer tools other than the Navigate tool when a viewer is placed in rotate mode. The same is true when attempting to resize a viewer when in rotate mode. Press the Stop button at the bottom of the ArcView application window or the ESC key to halt rotation before attempting to use a tool other than Navigate.

• The output from the 3D Viewer Save As Image tool will always be GIF if you have a GIF license. This is true even though the default output presented to the user suggests it will be JPEG.

• On all UNIX platforms, if a theme simplifies when navigating in a scene (i.e. turns into a bounding box), and you use the arrow keys to navigate, the simplified version remains rendered when the keys are released. Use the mouse to get the detailed version back.

• On all UNIX platforms, interactive navigation will halt if the cursor is positioned outside the 3D viewer window and inside the ArcView application window. Keep the cursor out of the ArcView application window while navigating.

• On the HP platform you can receive the following error message when loading the 3D Analyst extension with ArcView GIS Version 3.0b: /usr/lib/dld.sl: Unresolved symbol: _XHPRoman8ToKeysym (code) from /usr/lib/X11/R6/libXhp11.2. This error is inconsequential and can be ignored. The problem is resolved when loading the extension with ArcView GIS Version 3.1.

• On Sun Platforms with Creator3D graphics cards - certain themes in a 3D scene may appear rendered with color dropouts or poor shading. Try toggling Show shading for features off on the 3D Theme Properties dialog, changing the Sun position on the 3D Scene Properties dialog, or using a different color scheme for theme symbolization.

• On Sun Platforms with Elite3D graphics cards - having multiple image themes or grid themes draped on TINs in a 3D scene can result in color flashing of themes or loss of color in the scene

• On the IBM platform,  operating system AIX 4.1.5.0 with GXT800P graphics adapter, you will need patch APAR IX77314. With the operating system AIX 4.2.1.0 and the GXT800P graphics adapter, you will need the APAR IX77402 patch.

Back to TOC

Questions and feedback

ArcView on-line help provides detailed information on how to contact ESRI Technical Support with any questions or comments. This information can be found in the booklet Obtaining technical support under the Need more help? booklet in the Contents page.

All questions and comments should be forwarded to ESRI Technical Support:

• Phone: 909-793-3774
• Fax: 909-792-0960
• E-mail: support@esri.com

Back to TOC

Sources for additional information

Subscribe to ESRI's World Wide Web based discussion forum list ARCVIEW-L

Visit the ESRI home page on the Internet

Our site also offers an Internet Relay Chat server, which allows you to contact other ArcView users and participate in scheduled on-line conferences, all in real time. The chat server is available at www.esri.com/chat.

For additional information regarding issues found since this software was released, please go to this web page: www.esri.com/software/arcview/faq.html.

Access ESRI's Fax On-Demand server

Back to TOC

All Rights Reserved.

Printed in the United States of America.

ArcView GIS software’s JPEG image extension is based in part on the work of the Independent JPEG Group.  Copyright © 1991-1996 Thomas G. Lane.  All Rights Reserved.
 

The information contained in this document is the exclusive property of Environmental Systems Research Institute, Inc.  This work is protected under United States copyright law and the copyright laws of the given countries of origin and applicable international laws, treaties, and/or conventions.  No part of this work may be reproduced or transmitted in any form or by any means, electronic or mechanical, including photocopying or recording, or by any information storage or retrieval system, except as expressly permitted in writing by Environmental Systems Research Institute, Inc.  All requests should be sent to Attention: Contracts Manager, Environmental Systems Research Institute, Inc., 380 New York Street, Redlands, CA 92373-8100 USA.

The information contained in this document is subject to change without notice.
 

RESTRICTED/LIMITED RIGHTS LEGEND

Any software, documentation, and/or data delivered hereunder is subject to the terms of the License Agreement.  In no event shall the Government acquire greater than RESTRICTED/LIMITED RIGHTS.  At a minimum, use, duplication, or disclosure by the Government is subject to restrictions as set forth in FAR §52.227-14 Alternates I, II, and III (JUN 1987); FAR §52.227-19 (JUN 1987) and/or FAR §12.211/12.212 (Commercial Technical Data/Computer Software); and DFARS §252.227-7015 (NOV 1995) (Technical Data) and/or DFARS §227.7202 (Computer Software), as applicable.  Contractor/Manufacturer is Environmental Systems Research Institute, Inc., 380 New York Street, Redlands, CA 92373-8100 USA.

In the United States and in some countries ESRI and ArcView are registered trademarks; and 3D Analyst, Avenue, ArcStorm, the ESRI globe logo, the ArcView 3D Analyst  logo, GIS by ESRI and GIS for Everyone are trademarks; and www.esri.com and @esri.com are service marks of Environmental Systems Research Institute, Inc. ArcView GIS uses Neuron Data’s Open Interface.

Other companies and products mentioned herein are trademarks or registered trademarks of their respective trademark owners.