{"id":268,"date":"2013-04-24T15:27:06","date_gmt":"2013-04-24T15:27:06","guid":{"rendered":"http:\/\/ri.itservices.manchester.ac.uk\/csf-apps\/?page_id=268"},"modified":"2013-12-19T14:50:04","modified_gmt":"2013-12-19T14:50:04","slug":"povray","status":"publish","type":"page","link":"https:\/\/ri.itservices.manchester.ac.uk\/csf-apps\/software\/applications\/povray\/","title":{"rendered":"Povray"},"content":{"rendered":"<h2>Overview<\/h2>\n<p>The Persistence of Vision Raytracer (<a href=\"http:\/\/www.povray.org\/\">POV-Ray<\/a>) is a is a high-quality free tool for rendering images of 3-dimensional scenes.<\/p>\n<h2>Restrictions on Use<\/h2>\n<p>Accessible to all users of the system. Please read the <a href=\"http:\/\/www.povray.org\/povlegal.html\">license\/copyright notice<\/a> before using this software. POV-Ray was compiled from source &#8211; please refer to the <a href=\"http:\/\/www.povray.org\/source-license.html\">source license<\/a>.<\/p>\n<h2>Setup Procedure<\/h2>\n<p>Two versions are available: 3.7 (supports SMP multi-threaded rendering) and 3.6.1 (single-core only). Load the required modulefile using:<\/p>\n<pre>module load apps\/intel-12.0\/povray\/3.7<\/pre>\n<p>or<\/p>\n<pre>module load apps\/intel-12.0\/povray\/3.6.1<\/pre>\n<h2>Running the Application<\/h2>\n<p>POV-Ray must be run in batch. <strong>Do not run POV-Ray on the login node<\/strong>. Version 3.7 will perform multithreaded rendering but you <strong>must<\/strong> tell Povray how many threads to use (even if using 1 core) otherwise it will grab all cores on a node.<\/p>\n<p>You must also prevent Povray from opening a preview window while rendering because you are running in batch.<\/p>\n<p>See the example jobscripts below for the required flags. Note that there is no space between the flag and its value (e.g., <code>+w320<\/code> to specify an output image width of 320 pixels).<\/p>\n<h3>v3.7 Serial batch job submission<\/h3>\n<p>You must ensure POV-Ray does not try to open a preview window while rendering. Use the <code>-D<\/code> for this. The following job script will run POV-Ray in batch:<\/p>\n<pre>\r\n#!\/bin\/bash\r\n#$ -S \/bin\/bash\r\n#$ -cwd\r\n#$ -V\r\n#### Serial job hence no -pe option needed\r\n\r\n# Specify number of Workers Threads (+WT options) even if serial job\r\n# Read example input file named scenes\/advanced\/biscuit.pov (+I option)\r\n# (will search for files relative to install location if not found locally)\r\n# Output to a .png file (default) named myimage.png (+O option)\r\n# Image width = 320 pixels, height = 240 pixels\r\n# DO NOT open a preview window (-D option)\r\n\r\npovray +WT$NSLOTS +Iscenes\/advanced\/biscuit.pov +Omyimage.png +W320 +H240 -D\r\n\r\n<\/pre>\n<p>Submit your job using<\/p>\n<pre>\r\nqsub <em>jobscript<\/em><\/pre>\n<p>where <em>jobscript<\/em> is the name of your jobscript.<\/p>\n<p>Once the job has completed image files can be viewed using <code>gthumb<\/code> or <code>eog<\/code>.<\/p>\n<h3>v3.7 Parallel batch job submission<\/h3>\n<p>You must ensure POV-Ray does not try to open a preview window while rendering. Use the <code>-D<\/code> for this. The following job script will run POV-Ray in batch:<\/p>\n<pre>\r\n#!\/bin\/bash\r\n#$ -S \/bin\/bash\r\n#$ -cwd\r\n#$ -V\r\n#$ -pe smp.pe 8    # Example: Use 8 cores\r\n\r\n# Specify number of Workers Threads (+WT options) even if serial job\r\n# Read example input file named scenes\/advanced\/biscuit.pov (+I option)\r\n# (will search for files relative to install location if not found locally)\r\n# Output to a .png file (default) named myimage.png (+O option)\r\n# Image width = 320 pixels, height = 240 pixels\r\n# DO NOT open a preview window (-D option)\r\n\r\npovray +WT$NSLOTS +Iscenes\/advanced\/biscuit.pov +Omyimage.png +W320 +H240 -D\r\n\r\n<\/pre>\n<p>Submit your job using<\/p>\n<pre>\r\nqsub <em>jobscript<\/em><\/pre>\n<p>where <em>jobscript<\/em> is the name of your jobscript.<\/p>\n<p>Once the job has completed image files can be viewed using <code>gthumb<\/code> or <code>eog<\/code>.<\/p>\n<h3>v3.6.1 Serial batch job submission<\/h3>\n<p>You must ensure POV-Ray does not try to open a preview window while rendering. Use the <code>-D<\/code> for this. The following job script will run POV-Ray in batch:<\/p>\n<pre>\r\n#!\/bin\/bash\r\n#$ -S \/bin\/bash\r\n#$ -cwd\r\n#$ -V\r\n#### Serial job hence no -pe option needed\r\n\r\n## This version is serial-only so no +WT option needed.\r\n# Read example input file named scenes\/advanced\/biscuit.pov (+I option)\r\n# (will search for files relative to install location if not found locally)\r\n# Output to a .png file (default) named myimage.png (+O option)\r\n# Image width = 320 pixels, height = 240 pixels\r\n# DO NOT open a preview window (-D option)\r\n\r\npovray +Iscenes\/advanced\/biscuit.pov +Omyimage.png +W320 +H240 -D\r\n\r\n<\/pre>\n<p>Submit your job using<\/p>\n<pre>\r\nqsub <em>jobscript<\/em><\/pre>\n<p>where <em>jobscript<\/em> is the name of your jobscript.<\/p>\n<p>Once the job has completed image files can be viewed using <code>gthumb<\/code> or <code>eog<\/code>.<\/p>\n<h2>Further Info<\/h2>\n<p>There are many POV-Ray command line options. Use <code>man povray<\/code> to read the manual page.<\/p>\n<p>Online documentation is available at <a href=\"http:\/\/www.povray.org\/documentation\/\">http:\/\/www.povray.org\/documentation\/<\/a>.<\/p>\n<h2>Updates<\/h2>\n<p>19-Dec-13 Added v3.7<\/p>\n","protected":false},"excerpt":{"rendered":"<p>Overview The Persistence of Vision Raytracer (POV-Ray) is a is a high-quality free tool for rendering images of 3-dimensional scenes. Restrictions on Use Accessible to all users of the system. Please read the license\/copyright notice before using this software. POV-Ray was compiled from source &#8211; please refer to the source license. Setup Procedure Two versions are available: 3.7 (supports SMP multi-threaded rendering) and 3.6.1 (single-core only). Load the required modulefile using: module load apps\/intel-12.0\/povray\/3.7 or.. <a href=\"https:\/\/ri.itservices.manchester.ac.uk\/csf-apps\/software\/applications\/povray\/\">Read more &raquo;<\/a><\/p>\n","protected":false},"author":2,"featured_media":0,"parent":31,"menu_order":0,"comment_status":"open","ping_status":"closed","template":"","meta":{"footnotes":""},"class_list":["post-268","page","type-page","status-publish","hentry"],"_links":{"self":[{"href":"https:\/\/ri.itservices.manchester.ac.uk\/csf-apps\/wp-json\/wp\/v2\/pages\/268","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/ri.itservices.manchester.ac.uk\/csf-apps\/wp-json\/wp\/v2\/pages"}],"about":[{"href":"https:\/\/ri.itservices.manchester.ac.uk\/csf-apps\/wp-json\/wp\/v2\/types\/page"}],"author":[{"embeddable":true,"href":"https:\/\/ri.itservices.manchester.ac.uk\/csf-apps\/wp-json\/wp\/v2\/users\/2"}],"replies":[{"embeddable":true,"href":"https:\/\/ri.itservices.manchester.ac.uk\/csf-apps\/wp-json\/wp\/v2\/comments?post=268"}],"version-history":[{"count":8,"href":"https:\/\/ri.itservices.manchester.ac.uk\/csf-apps\/wp-json\/wp\/v2\/pages\/268\/revisions"}],"predecessor-version":[{"id":1208,"href":"https:\/\/ri.itservices.manchester.ac.uk\/csf-apps\/wp-json\/wp\/v2\/pages\/268\/revisions\/1208"}],"up":[{"embeddable":true,"href":"https:\/\/ri.itservices.manchester.ac.uk\/csf-apps\/wp-json\/wp\/v2\/pages\/31"}],"wp:attachment":[{"href":"https:\/\/ri.itservices.manchester.ac.uk\/csf-apps\/wp-json\/wp\/v2\/media?parent=268"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}