Print

Installation of the Huygens Software


On different platforms all the avaliable programs of the HuygensSoftware are installed automatically as part of the HuygensSuite. The suite can be downloaded here. Since installation details may change as new versions are released, for up to date details please visit this wiki page or have a look at the manuals.

To use all features of the different programs, valid License Strings should be purchased, but test licenses are also available on request.



Installation


Installation on Mac OS


Image
Go to the folder were you downloaded the distribution and double-click on it. It will be extracted by StuffIt Expander to a .pkg file, which will be placed in the same directory. Double click this .pkg file, and follow the installation wizard.

If the automatic extractions fails, you can always open a terminal window (a shell) and command the following:
gunzip huygens-file.pkg.tar.gz
tar xf huygens-file.pkg.tar

Notice that the huygens-file as you download it will change its extension after each step. At the end you'll get a huygens-file.pkg that you can double click to install.

Only users with administrative privileges can install applications in the default destination.

If you want to install the application in a directory different to the default one (because you are beta-testing a new release, or because you don have enough permissions, for example) specify the destination directory while you use the installation wizard.

If any problem occurs during the installation, please copy the error messages as displayed in the installer log (Window > Installer log) and send them to SVI.

Installation on Microsoft Windows


You have received an executable file for installation, for instance huygens-331p0.exe. Double click its icon to start the installation. During installation, the directory C:\Program files\SVI\ will be created by default (-+C:\Program files (x86)\SVI\+- on 64-bit Windows versions). You may specify a different installation directory if necessary. After completion the Huygens Essential, Professional, Scripting, and FreeSFP icons appear on your desktop. Double click on one of these icons to start the program.

Installation on Linux


RedHat or SuSE users, or users with another RPM-based Linux, should download the .rpm installer, for instance huygens-3.3.0-p2.x86_64.rpm. Double click the file, or open a terminal, go to the directory where this file is located, become root and type:
rpm -ivh --force huygens-3.3.0-p2.x86_64.rpm


Ubuntu users, or users with another Debian-based Linux, should use the the .deb installer, for instance huygens_3.3.0-p2_amd64.deb. Double click the file, or open a terminal, go to the directory where this file is located and type:
sudo dpkg -i huygens_3.3.0-p2_amd64.deb


In contrast to RPM, the Debian package manager removes the previous package before installing the new one.

Double click on of the desktop icons to launch the software, or open a terminal and type huygenspro, essential, huscript, or freesfp. A directory /usr/local/svi will be created; symlinks to the executables will be installed in /usr/local/bin.

Installation on SGI Irix 6.5


Currently the Irix distribution is a single tardist file containing various components. By default all components are installed. Become root and type:
swmgr -f huygens-2.9.3-p2.tardist

Press Start in the Software Manager window. A directory /usr/local/svi will be created; the executables will be installed in /usr/local/bin and /usr/sbin.


After the installation


After a first-time installation there is not yet a license available. Still, you can start the software. Without a license it will run in `Freeware mode'. Among others, this gives you access to the License tools in the Help menu.

Launching the application


On Linux or Irix start the software by clicking its icon or by typing the program name (-+essential+-, huygenspro, huscript or freesfp) into a Unix shell. If this doesn't work directly, you may need to add the application directory to the search path, see below.

On Mac OS and Windows click on the application icon.

You can also use an X11 shell in the Mac to run the programs from the command line. Go to the program directory, usually /Applications/SVI/bin and type ./essential (mind the dot-slash) or other application name to launch the Aqua version. This you need to do in any case when you are running the program remotely from another machine: in that case use the remote version, type ./essential.remote or ./essential -remote (again, mind the dot-slash syntax). See running remotely for more details on the Mac and other platforms remote execution.

Without a license the software will open in FreeWare mode and display the start-up window.

Installing a license


License String explains how to obtain and install a license string.

Adding to the shell search path


Users of the csh or tcsh shell can add the /usr/local/bin or /usr/sbin/ directory to their shell search path by adding the following line to the .cshrc file in their home directory:

set path=(/usr/local/bin $path) or set path=(/usr/sbin $path)<br />
You can inquire your shell by typing: echo $SHELL


Updating the software


Download the new version from the SVI website at http://www.svi.nl. Proceed with the installation as explained above.

Do not uninstall the old version as this will delete your license string.
On Mac OS make sure you make a backup of the license string in a safe place before you remove the previous installation.

Removing the software


  • Irix: Open the Software Manager, select Manage Installed Software, and mark the packages you wish to remove.
  • Mac OS: Drag the installation to the waste basket.
  • Microsoft Windows: Clicking Start in your Windows desktop and select: Programs > Huygens Essential > Uninstall.
  • Linux: see below.

Removing the software will also cause your license string to be removed. If you prefer to uninstall your current version prior to installing a newer one, be sure to store your license string in a safe place.

More details for Linux


If Huygens was installed using RPM, you can use this command to remove the package:
rpm -e huygens

If the package manager complains that multiple versions are installed, then query for the installed versions and remove them one-by-one:
rpm -q huygens

To remove packages using Debian package manager, type
dpkg -r huygens

To query for packages installed by the Debian package manager, use
dpkg-query -W huygens

System requirements for Huygens


Windows and Linux


Huygens runs on the following Windows operating systems:
  • 2003 Server;
  • XP (32 and 64 bit edition);
  • Vista (32 and 64 bit edition);
  • Windows 7 (32 and 64 bit edition)

On Linux, the RedHat, SuSE and Ubuntu distributions are supported.

  • A standard ethernet card is required to provide your computer with a system ID.
  • Processor: AMD Athlon or Intel Pentium 4 and higher.
  • RAM memory: 2 GB or larger.
  • Graphics card: any fairly modern card will do.

Mac OS


  • Operating system: Mac OS 10.4 or higher. Mac OS 10.5 or higher is required for full 64 bit capabilities.
  • Processor: Intel or G5 PowerPC or higher. Mac OS 10.5 or higher is required for full multiprocessor support on Intel platforms.
  • RAM memory: 2 GB or larger.

SGI Irix


Huygens Essential and Huygens Scripting run on all SGI equipment running Irix 6.5 on a MIPS R10000 processor or higher. The recommended RAM size is 2 GB or larger. The last available Huygens version for Irix is 3.5.

Version information


All SVI software packages contain an image processing engine called the Huygens Compute Engine (HuCE). Though different packages may contain different version numbers for their interfaces, the most relevant version number is the common one of the HuCE. The version number of the HuCE is can be seen in Help > About in all packages with a graphical interface, and is returned by the huOpt version command.