This page describes the steps required to participate in the weatherathome project covering the Southern African region. The same steps apply for the other weatherathome regions, with the appropriate change in the region selection.
Requirements
In order to participate in this project you need to have a desktop computer running the Microsoft Windows operating system. We hope to have versions running for Linux and Mac systems soon. In the meantime, Linux and Mac users are invited to participate in other climateprediction.net experiments.
At least 250MB of computer memory is required in order to run the computer models in this project. Multiple simulations can be run simultaneously on multi-core computers, but apparently the simulations will run a little (about 10%) more slowly than if a single simulation was using one of the processor cores.
Switching projects (existing participants)
If you already have a climateprediction.net account, then login to your project preferences. Click on "Your account" in the side menu. Then click on "climateprediction.net preferences". Scroll down the page and click "Edit climateprediction.net preference". There will be a section that looks like this:

Select "UK Met Office HadAM3P Southern Africa" and de-select the other options. Scroll down to the bottom and select the "Update preferences" button.
Finally, logout by clicking on the "Log out" link under the "Account information" heading. From now on all new jobs you are assigned from climateprediction.net will be for the weatherathome--Southern Africa project.
Registration (new participants)
If you do not already have a climateprediction.net account then you need to register with the climateprediction.net project (of which the weatherathome project is a part).
Go to the registration page and fill in the form. Make sure to select "Southern Africa" as the experiment in the last item of the list.
Once registered, you will be brought to a screen titled "Welcome to climateprediction.net". In this page you can changing your account details, alter your default computing preferences (e.g. the maximum amount of you CPU usage to use), and view how much computing you have done for the project (currently 0.00). For now, simply click on the "Log out" link under the "Account information" heading.
Downloading and installing BOINC (new participants)
This project uses the BOINCprogram. You can download this program from here.
Go to wherever you downloaded the BOINC program, and click on the following BOINC icon. If you receive a security warning, click "Run". After some configuration work, a standard installation wizard window will open. Click on the "Next" button.

The next page will list the license agreement. Read the agreement and if you accept it then click on "I accept the terms of the license agreement" and click the "Next" button.
The next page will ask which directories to use for the program. Once you are happy with the selections, click the "Next" button. On the next screen, click on the "Install" button to begin the installation. Once the installation is finished, click on the "Finish" button.

Connecting to the project (all participants)
To start the BOINC program, go the Windows "Start" menu, click on "All Programs", and select "BOINC", and click on "BOINC Manager". A window will appear asking if you want to attach to a project or account manager. Click on "Attach to project" and then click on the "Next" button.

On the next screen select "Climateprediction.net" and then click on the "Next" button.

You will then be asked to identify your account. Click on "Yes, existing user" and enter the e-mail address and passward you used to register with climateprediction.net.

Click "Finish" on the final screen.
You will now be left with a "BOINC Manager" window which tells you that you are downloading programs and data from the server required to run the climate simulation. This amounts to about 130MB in size. The download size will be smaller when you start subsequent simulations, because you will have already downloaded a lot of the programs and data required.
If you would like to monitor progress of the download, then click on "Advanced View" and in the new window click on the "Transfers" and "Messages" tabs.
You may want to adjust the settings determining how many simulations you will be running (if you have a multi-core machine) and how much of the CPU usage is used by each simulation. These settings can be changed by logging into your climateprediction.net account or by opening the BOINC Manager, clicking on "Advanced View", clicking on "Advanced" in the menu at the top, and clicking on "Preferences...".
Once everything is downloaded, the simulation will start automatically.
Watching the models run (all participants)
Once the simulation has started, you can monitor the progress using the graphics program provided with the project. In the BOINC Manager, go to the "Tasks" tab, click on the simulation listed in the main part of the window, and click on the "Show graphics" button on the left.

A new window will open showing showing the cloud cover from the global climate model as default. You can view other quantities by pressing the keys listed in the menu on the left, e.g. "t" to view temperature.

If you press "w" twice, the view will shift from showing what the global climate model is doing to what the regional model is doing. This view will be restricted to the area covered by the regional climate model, i.e. southern Africa. The default is to show cloud cover, but once again you can view other aspects by pressing the keys listed in the menu on the left.

If you are trying to view the regional graphics just after starting the simulation, you may find a blank window. The global model has to run for a little while before there is sufficient information for it to give the regional model in order than the regional model can run, so in fact the regional model has not yet started running. Just wait a few minutes and the graphics for the regional model should pop into the window.
Note that there is a known bug in the graphics program which is offsetting the outline of the land in the regional view to the east of what it should be. Most visibly, the outline of Madagascar is farther east than Madagascar actually is in the model. This problem will be fixed in an upcoming upgrade.
Managing your simulation (all participants)
If at any time you want to pause the simulation, open the BOINC Manager, go to the "Tasks" tab, click on the simulation listed in the main part of the window, and then click the "Suspend" button on the left.

To continue the simulation, open the BOINC Manager again, go the "Tasks" tab, click on the simulation listed in the main part of the window, and click the "Resume" button on the left.

Results of the simulation (all participants)
During the simulation, the program will automatically send 3.5MB of results at the end of each month of climate model time to a central server. At the end of the simulation, the model will also send 32MB of data required to start a new simulation which continues from the end of your simulation.
A single simulation, spanning 12 months of climate model time, takes about 4 days to complete running full time on a 2.4GHz computer.