POV-RAY

Description
	The Persistence of Vision Raytracer, POV-RAY, is a free tool for creating three-dimensional images from descriptions written in a customised scripting language.
Site	Version (Latest: 3.6.2)	Notes
ngs.oerc.ox.ac.uk	3.6.1

 License

• POV-RAY is distributed under a permissive license, intended to encourage wide-spread use
• The exact terms of the end-user license can be found at http://www.povray.org/povlegal.html

Users of this application should credit the code authors and the NGS accordingly and where applicable the specific site where the code is installed, when publishing work using NGS resources. 

Running the Application on the NGS (General)

• Submission Using the UI/WMS

  To submit an POV-RAY job via the WMS, login to the UI and create a JDL file as below, then submit using:

    glite-wms-job-submit -o jobIDs -a povray.jdl

  Type = "Job";
  JobType = "normal";
  Executable = "/usr/ngs/POVRAY"; 
  Arguments = "+Iinput.pov -D +FN +Ooutput.png"; 
  CpuNumber = 1; 
  StdOutput = "std.out"; 
  StdError = "std.err"; 
  Myproxyserver= "myproxy.ngs.ac.uk"; 
  InputSandbox = {"input.pov"}; 
  InputSandboxBasetURI ="gsiftp://ngsui03.ngs.ac.uk:2811/home/ngsxxxx/povtest";
  OutputSandbox = {"std.err","output.png","std.out"}; 
  OutputSandboxBaseDestURI ="gsiftp://ngsui03.ngs.ac.uk:2811/home/ngsxxxx/povtest";
  Requirements = (      
       member("NGS-UEE-POVRAY", other.GlueHostApplicationSoftwareRunTimeEnvironment)
  );
  ShallowRetryCount = -1;
  

• Submission Using Globus

 The equivalent Globus commands for submitting the job to a single host and copying the input and output files are as follows. Each command should be on one line. You should not include the backslashes:

globus-url-copy -cd -rp file:///$PWD/input.pov gsiftp://ngs.leeds.ac.uk/povtest/input.pov
globus-job-run ngs.leeds.ac.uk/jobmanager-pbs -d povtest \
  /usr/ngs/POVRAY +Iinput.pov -D +FN +Ooutput.png
globus-url-copy -rp gsiftp://ngs.leeds.ac.uk/povtest/output.png file:///$PWD/output.png
 

• This runs the default version. To run 3.6.1 use POVRAY_3_6_1 instead of POVRAY.
• Many examples are available on the POV-RAY website

Further Information

• Documentation can be found on the POV-RAY website
• A selection of the best POV-RAY generated images is available from the Hall-of-Fame