Difference between revisions of "Running VisIt on OS X"

(Running)
Line 1: Line 1:
VisIt is used mostly in Unix environments.  Starting VisIt with OS X is straightforward, but it works in a very different manner than a typical Mac user usually expects.
+
VisIt is used mostly in Unix environments.  Starting VisIt with OS X is straightforward as it is simply a MacOS X application bundle.
  
First download the [http://www.llnl.gov/visit/executables.html Darwin binary]. You will probably want to download the Darwin/i386 distribution to get the binaries for an Intel based Mac. Note that filename ends in .gz, that is, a compressed file using the gzip compression library. Some browsers on the Mac want to automatically decompress this file. Make sure that you save it intact to your desktop without decompressing it. Next, also download the visit-install installation script.
+
First download the [http://www.llnl.gov/visit/executables.html Darwin binary]. Binaries are provided the following platforms:
 +
* 32-bit Intel ''(Mac 10.5 and later)''
 +
* 64-bit Intel ''(Mac 10.6 and later)''
  
=Installing=
+
Click on the ''Download'' links to download the Mac application bundle stored as a 'DMG'' file.
You will need to open the Mac Terminal application. This is located in Applications, Utilities, Terminal.app.  When run, this application is the text shell at the heart of most Unix applications. Assuming you saved the VisIt binaries and visit-install script to your desktop, you can install using these UNIX commands. Be sure to type them exactly:
+
[[Image:VisItMac_download.png]]
<code><pre>
+
 
mkdir visit
+
Double-click the ''DMG'' file so your Mac opens it and exposes the VisIt application bundle. Drag the ''VisIt'' application to your desktop to copy it to your Mac.
cd Desktop
+
 
chmod 700 visit-install
+
[[Image:VisItMac_dmg.png]]
./visit-install 1.12.0 darwin-i386 ~/visit
+
 
</pre></code>
+
=Running=
 +
To run VisIt, simply double-click the ''VisIt'' application on your desktop.
 +
 
 +
When you run VisIt for the first time, you will have the option to install any network configurations for computing centers such as LLNL, ORNL, LBL, and Sandia. If you do not use computing resources at those sites, you can skip the network configuration.
  
When prompted for a host config file, you can choose to not have one. You can also skip adding a default bank.
+
==Running from the command line==
 +
If you run VisIt from the Terminal application, you will have to reference the ''visit'' launch script within the ''VisIt.app'' application bundle. You can put that script in your path to make it easier to invoke.
  
Now, let's put VisIt in your path (assuming your default shell is csh/tcsh). This means that you will be able to simply type '''visit''' from the Terminal command line in order to launch it. Open the file called ''/Users/myname/.cshrc'' and add the following line to the end of the file (be sure to replace '''myname''' with your login name):
+
Open the file called ''/Users/myname/.cshrc'' and add the following line to the end of the file (be sure to replace '''myname''' with your login name):
 
<code><pre>
 
<code><pre>
set path=($path /Users/myname/visit/bin)
+
set path=($path ~/Desktop/VisIt.app/Contents/Resources/bin)
 
</pre></code>
 
</pre></code>
  
=Running=
+
Once you have added the ''visit'' command to your path, you can simply type '''visit''' at the prompt to launch VisIt when you run from the Terminal.
We recommend running VisIt from the command line of the Terminal application so open up Terminal.
 
 
 
Since you added VisIt to your path, you can simply type '''visit''' at the prompt to launch VisIt.
 
  
 
[[Category: User Documentation]]
 
[[Category: User Documentation]]

Revision as of 23:41, 5 April 2012

VisIt is used mostly in Unix environments. Starting VisIt with OS X is straightforward as it is simply a MacOS X application bundle.

First download the Darwin binary. Binaries are provided the following platforms:

  • 32-bit Intel (Mac 10.5 and later)
  • 64-bit Intel (Mac 10.6 and later)

Click on the Download links to download the Mac application bundle stored as a 'DMG file. VisItMac download.png

Double-click the DMG file so your Mac opens it and exposes the VisIt application bundle. Drag the VisIt application to your desktop to copy it to your Mac.

VisItMac dmg.png

Running

To run VisIt, simply double-click the VisIt application on your desktop.

When you run VisIt for the first time, you will have the option to install any network configurations for computing centers such as LLNL, ORNL, LBL, and Sandia. If you do not use computing resources at those sites, you can skip the network configuration.

Running from the command line

If you run VisIt from the Terminal application, you will have to reference the visit launch script within the VisIt.app application bundle. You can put that script in your path to make it easier to invoke.

Open the file called /Users/myname/.cshrc and add the following line to the end of the file (be sure to replace myname with your login name):

set path=($path ~/Desktop/VisIt.app/Contents/Resources/bin)

Once you have added the visit command to your path, you can simply type visit at the prompt to launch VisIt when you run from the Terminal.