installation.txt

EFFECT - Installation

1. You must have Python 2.5 installed.

2. Unzip the Effect archive anywhere you like (such as your home directory).

3. From the bash command-line, navigate to the 'setup' directory, and run the
initial_setup script. This script copies some Effect resources to the
/Users/Shared directory.

On bash (the OS X default), you would type "sh initial_setup.bash".

4. Set the EFFECTHOME environment variable.

Add these lines to your .bashrc file:
EFFECTHOME=path-to-the-effect-directory
export EFFECTHOME

NOTE: path-to-the-effect-directory could look something like:
/Users/username/effect

Also see sample_bashrc.txt for an example .bashrc file.

5. Make sure that Radiance has been placed in your path before Vim. If not,
Effect's rview operations will not work.

6. To run Effect, you have 3 choices:

1. Run Effect directly from the bash command-line. You must navigate to the
EFFECTHOME/bin directory and type "python effect.pyc"

2. Launch Effect from anywhere using a shell script. The script,
effect_startup.bash, is located in the 'setup' directory. It can be
copied to any directory you like. To launch Effect, navigate to the
directory containing the script and type "sh effect_startup.bash".

3. Launch Effect from anywhere using a click-able app. The app called
EffectStartup is located in the 'setup' directory. It can be copied
anywhere, including to the Desktop or to the Dock.

NOTE: Effect uses the bash shell. If you are a C shell user, you may need to
create a .bashrc file in addition to your .cshrc file. You will need to set
EFFECTHOME in .bashrc, as described above. You will also need to add Radiance
to your PATH and create the RAYPATH variable in the .bashrc file. Thus, you
will have set up your Radiance variables in both the .cshrc and .bashrc files.
Otherwise, your .cshrc file will remain the same as before.