Skip to content

InstallationWindowsSource

Jump to bottom
shawnlaffan edited this page Jul 10, 2016 · 27 revisions

These instructions apply to version 0.18 and later.

These assume you have saved the Biodiverse source code to C:\biodiverse. If you have not then change the C:\biodiverse\lib path in the following to the appropriate path.

IMPORTANT: You need to be sure to run step 4 from the installation every time you want to run the system. (This is until we develop a batch script to handle it).

DO NOT USE A PATH WITH SPACES IN IT. This causes problems with the batch file used to run the source code version. (This has no effect on the executable file).

StrawberryPerl

Installation

  1. Install Strawberry Perl 5.16.3, 64 bit. The rest of these instructions assume you have used C:\strawberry as the install folder. If you have not then edit the paths below to match what you have used. http://strawberryperl.com/ IMPORTANT: MAKE SURE YOU USE 5.16.3 and NOT 5.18, 5.16.1 or 5.16.2, or anything else. There are installation problems with these versions related to gdal, and we do not currently have working gdal ppms for Strawberry Perl 5.18 or later (needed for step 6)

  2. Download the source code version to obtain a stable release. Alternately you can use a GIT client to get the latest Biodiverse code, see https://github.com/shawnlaffan/biodiverse and the clone URL there.

  3. Open a command prompt. The rest of these instructions assume you are at the prompt.

  4. Run these commands, editing the folder paths as needed to match your system.

  set BDV_PATH=c:\biodiverse
  set STRAWPATH=c:\strawberry
  set GTK_PATH=c:\gtk_win64
  set GDAL_PATH=c:\gdal_win64
  set PATH=%STRAWPATH%\bin;%STRAWPATH%\perl\site\bin;%STRAWPATH%\perl\vendor\bin;%STRAWPATH%\perl\bin;%GTK_PATH%\c\bin;%GDAL_PATH%\bin;%PATH%

  1. Download the gtk_win64 and gdal_win64 components and unzip them so the top level of each matches the GTK_PATH and GDAL_PATH variables you set in the previous step. Make sure you do not have c:\gdal_win64\gdal_win64, for example.

  2. Now we need to install some files using the ppm and cpanm utilities. In the same command prompt that you ran the commands from step 1, run the ppm install command for all ppd files. You can copy and paste these into the command prompt.

  :: Install the precompiled binaries needed for the GUI.
  set BDV_PPM=https://github.com/shawnlaffan/biodiverse/raw/ppm/ppm516_x64
  ppm install %BDV_PPM%/Cairo.ppd 
  ppm install %BDV_PPM%/Glib.ppd 
  ppm install %BDV_PPM%/Gnome2-Canvas.ppd 
  ppm install %BDV_PPM%/Pango.ppd
  ppm install %BDV_PPM%/Gtk2.ppd
  ppm install %BDV_PPM%/Gtk2-GladeXML.ppd
  ppm install %BDV_PPM%/Geo-GDAL.ppd


  :: Spreadsheet::XLSX 0.15 does not install on Windows 
  :: and will be removed in the next Task::Biodiverse::NoGUI update
  :: until then install version 0.13
  cpanm Spreadsheet::XLSX@0.13

  :: Spreadsheet::ParseXLSX version 0.24 does not install on Windows
  cpanm Spreadsheet::ParseXLSX@0.23

  :: Now install the rest of the dependencies
  :: You might need to re-run the preceding two lines a few times as 
  :: anti-virus scanning can cause test failures due to file locks.
  cpanm Task::Biodiverse::NoGUI
  cpanm Task::Biodiverse

Running it

The above installation process should install all the relevant files, so we can now run it.

  1. This is the same as step 1 in the installation instructions, but needs to be run every time you open a new command prompt (unless you add the paths to your PATH variable at the windows level). Remember to edit the folder paths if you installed Biodiverse, the Gtk libs, GDAL libs and/or Strawberry Perl to different folders. Note that Biodiverse goes looking up the directory tree for Gtk and GDAL using the installation names in the previous steps, so you only need to add them to the path if you put them somewhere else.
  set BDV_PATH=c:\biodiverse
  set STRAWPATH=c:\strawberry
  set PATH=%STRAWPATH%\bin;%STRAWPATH%\perl\site\bin;%STRAWPATH%\perl\vendor\bin;%STRAWPATH%\perl\bin;%BDV_PATH%\bin;%PATH%
  1. Now you can run it.
  perl %BDV_PATH%\bin\BiodiverseGUI.pl

Trouble shooting

  • If you get errors about not finding gnome-canvas, glib and friends then check that the %GTK_PATH%\c\bin directory exists and is correctly named.

  • If Perl complains that it cannot locate a file when running Biodiverse then this library will need to be installed interactively using cpan. The complaint will contain text like Can't locate Fred/Fred.pm in @INC (@INC contains:...) In this case, install module Fred::Fred (substitute a double colon "::" for each forward slash "/", and remove the trailing ".pm" from the module it cannot locate). E.g.: cpanm Fred::Fred . This can happen if one or more of the modules listed in the Task distributions failed to install.

  • Please report any other issues using the project issue tracker

Clone this wiki locally