I apologize to those of you who may find these instructions too detailed, but they are written for people who may not be familiar with the details of the system, and who may never have seen the command line interface for the Mac.
Getting Started
These instruction will be much easier if you set your Mac windows to display as lists of files. To do this when a disk or folder window opens look in the upper left corner. You will see a few icons there. There will be a right and left pointing arrow and just to the right of that are three icons. Click on the center icon of those three to set the list mode. As you follow these directions if a window opens that is not in list mode, repeat this adjustment. This will allow you to open folders by clicking on the small pointer that will appear next to each folder name and prevent the system from opening a separate window for each folder as you go. It will also allow you to see the relationships between all the folders.
1) Locate the climate prediction folder - To find the folder go tho the top level directory of your startup disk by double clicking on the disk icon on your desk top, locate the "Library" folder and click on the small arrow to the left of the folder icon to view the contents. Inside the "Library" folder you will find a folder named "Application Support", click on the arrow to view its contents. Inside the "Applications Support" folder you will see a folder named "BOINC Data", click on the arrow to view its contents. Inside the "BOINC Data" folder you will find a folder named "projects", click on the arrow to view its contents and you will find the "climateprediction.net" folder, click on the arrow to view its contents.
2) Near the bottom of the files listed in the "climateprediction.net" folder you will see a file named "vis". This is the ClimatePrediction model program that you must run in the terminal window using the "Terminal" utility program which can be found in the Utilities folder inside the "Applications" folder on your startup disk.
First the climate prediction model must be loaded in memory on the system for the model visualization to work properly. This means that the system must be actively running the model work unit or at least have the model loaded in the system memory. You can avoid this limitation if you set your preferences option for "Leave applications in memory while preempted" on the climate prediction website to "Yes". However if the model is not actively processing it will not show all of the details it would otherwise.
Here is the easiest way to run the model.
First start up the "terminal" application from the "Utilities" folder. This will open the terminal window and a prompt will appear. By default the window opens attached to and able to use resources in your Mac user folder, so the prompt should have the name of your system followed by your user login ID as the prompt.
Last login: Sat Aug 20 13:13:05 on ttyp1
Welcome to Darwin!
Your-Computer:~ YourID$
Move the window to one side of your screen to make room for the next step.
Now open the "climateprediction.net" folder as described above. and move it over so you can see the terminal window.
On the command line in the terminal window type in "cd " (the letters "cd" followed by a space). Go to the open disk window and grab the "climateprediction.net" folder icon and drag it to the terminal window and drop it there (all this does is type the directory path for you). The directory path should now appear in the terminal window so now the command line will look something like this -
Your-Computer:~ YourID$ cd /Library/Application\ Support/BOINC\ Data/projects/climateprediction.net
Press the "return" key on your keyboard. The system should respond with -
Your-Computer:/Library/Application Support/BOINC Data/projects/climateprediction.net YourID$
Now go back to the open "climatprediction.net" folder. and grab and drag the "vis" program we located above into the terminal window and drop it. Once again this is only to avoid a lot of typing and possible typing errors. Your command line should now look something like this-
Your-Computer:/Library/Application Support/BOINC Data/projects/climateprediction.net YourID$ /Library/Application\ Support/BOINC\ Data/projects/climateprediction.net/viz
Press the return key on your keyboard. The system should respond with -
Searching for active shared memory
Using Model ID Your_model_ID number_here
Once the model is running
Assuming the "vis" program finds a valid model it will open the model in a new window. There are a number of commands that you can use to change the model display. Type the letter "H" and the available commands will appear in the model window. You can also grab the globe with your mouse and rotate or spin it.
To exit the model window and close the model press the "ESC" key in the upper right corner of your keyboard.
Viewing different models on your system
If you are running more than one model on your system the "vis" program will to allow you to enter the model number for any of the models you are running as a command line option to pick the model it will display. You do this by simply adding the model number after you drag and drop the "vis" program into the terminal window and before you press the return key. So the command would look like this- (note there is a space between "Vis" and "Model_Number")
Your-Computer:/Library/Application Support/BOINC Data/projects/climateprediction.net YourID$ /Library/Application\ Support/BOINC\ Data/projects/climateprediction.net/viz Model_Number
Unable to attach to shared model
If the model is not in memory (either running or kept in memory while the system processes other work) you will get the message-
Using cmd line arguments Model_Number
Unable to attach to shared memory
You will either have to reset your preferences as described above on the Climateprediction web site, and/or wait for the model to restart on the next processing cycle.
Enjoy
Phil
Top
