{"id":1713,"date":"2019-02-21T12:03:04","date_gmt":"2019-02-21T12:03:04","guid":{"rendered":"http:\/\/ri.itservices.manchester.ac.uk\/csf3\/?page_id=1713"},"modified":"2019-03-14T19:43:17","modified_gmt":"2019-03-14T19:43:17","slug":"crystal-analysis-tool","status":"publish","type":"page","link":"https:\/\/ri.itservices.manchester.ac.uk\/csf3\/software\/applications\/crystal-analysis-tool\/","title":{"rendered":"Crystal Analysis Tool (draft)"},"content":{"rendered":"<table class=\"hint\">\n<tr>\n<td><em>If you are a windows user &#8211; please ensure you create your jobscript ON THE CSF directly using <a href=\"\/csf3\/software\/tools\/gedit\/\">gedit<\/a>. This will prevent your job going into error (Eqw). Text files created on windows have hidden characters that linux cannot read. For further information please see the <a href=\"\/csf\/getting-started-on-the-csf\/using-the-csf-from-ms-windows\/\">guide to using the system from windows<\/a>, in particular the section about <a href=\"\/csf\/getting-started-on-the-csf\/using-the-csf-from-ms-windows\/#textfiles\">text &amp; batch submission script files<\/a><\/em>.\n<\/td>\n<\/tr>\n<\/table>\n<h2>Overview<\/h2>\n<p>Crystal Analysis Tool is a package for analysing the output of atomistic simulation of crystalline solids. It can be used to identify lattice structures and defects and to determine additional properties.<\/p>\n<h2>Restrictions on use<\/h2>\n<p>While the tool is freely available to download, the README contains the following copyright statement:<\/p>\n<pre>\r\nCopyright 2012-2013, Alexander Stukowski\r\nAll rights reserved. Contact the author for permission to use, copy, modify or redistribute this software.\r\n\r\nTHIS SOFTWARE IS PROVIDED \"AS IS\", IN THE HOPE THAT IT WILL BE USEFUL, BUT WITHOUT ANY WARRANTY;\r\nWITHOUT EVEN THE IMPLIED WARRANTY OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PRUPOSE. IN NO EVENT SHALL\r\nTHE AUTHOR BE LIABLE FOR ANY DAMAGES WHATSOEVER ARISING OUT OF THE USE OF OR INABILITY TO USE THIS SOFTWARE.\r\n\r\nThis product includes software developed by Silicon Graphics, Inc.,  \r\nlicensed under the SGI Free Software License B (http:\/\/oss.sgi.com\/projects\/FreeB\/) \r\n<\/pre>\n<h2>Setup procedure<\/h2>\n<p>To use Crystal Analysis Tool, load the modulefile into your environment as follows:<\/p>\n<pre>\r\nmodule load apps\/gcc\/crystal-analysis-tool\/0.9.20\r\n<\/pre>\n<h2>Running the application<\/h2>\n<p>The executable is named CrystalAnalysis. Please do not run this on the login node; follow the instruction below to submit a batch job instead.<\/p>\n<h3>Parallel batch job submission<\/h3>\n<h3>Example job<\/h3>\n<pre>\r\n$ ls\r\njobscript  npAu.dump.gz\r\n<\/pre>\n<pre>\r\n#!\/bin\/bash --login\r\n#$ -cwd\r\n#$ -pe smp.pe 8\r\n#$ -N npAu\r\n\r\nmodule load apps\/gcc\/crystal-analysis-tool\/0.9.20\r\n\r\n# Name of the simulation snapshot file:\r\ninputFile=\"npAu.dump.gz\"\r\n\r\n# List of structure patterns to search for:\r\npatterns=\"fcc,fcc_isf,fcc_triple_sf,fcc_quad_sf,fcc_coherent_twin\"\r\n\r\n# Neighbor list cutoff radius:\r\ncutoff=3.6\r\n\r\n# Base name of output files:\r\noutputFile=$(basename $inputFile .dump.gz)\r\n\r\n# Run analysis program:\r\nmpirun -np $NSLOTS CrystalAnalysis \\\r\n   -catalog $CATOOL_DB \\\r\n   -patterns $patterns \\\r\n   -cutoff $cutoff \\\r\n   -cell ${outputFile}.cell.vtk \\\r\n   -atoms id,type,x,y,z,pattern,cluster ${outputFile}.atoms.dump.gz \\\r\n   -scounts ${outputFile}.counts.txt \\\r\n   -defectsurface ${outputFile}.defectsurface.vtk \\\r\n   -defectsurfacecap ${outputFile}.defectsurfacecap.vtk \\\r\n   -dislocations ${outputFile}.dislocations.vtk \\\r\n   -output ${outputFile}.ca \\\r\n   $inputFile > ${outputFile}.log\r\n<\/pre>\n<p>The environment variable CATOOL_DB is defined in the modulefile for your convenience.<\/p>\n<pre>\r\n$ ls -ltr\r\ntotal 47236\r\n-rw-r--r-- 1 me mygroup  7099468 Dec  7 13:04 npAu.dump.gz\r\n-rwxr-xr-x 1 me mygroup      969 Jan  2 10:03 jobscript\r\n-rw-r--r-- 1 me mygroup        0 Jan  2 10:03 npAu.o68110\r\n-rw-r--r-- 1 me mygroup      198 Jan  2 10:03 npAu.e68110\r\n-rw-r--r-- 1 me mygroup      361 Jan  2 10:03 npAu.cell.vtk\r\n-rw-r--r-- 1 me mygroup      173 Jan  2 10:04 npAu.counts.txt\r\n-rw-r--r-- 1 me mygroup  9502680 Jan  2 10:04 npAu.atoms.dump.gz\r\n-rw-r--r-- 1 me mygroup 16644529 Jan  2 10:04 npAu.ca\r\n-rw-r--r-- 1 me mygroup 13713294 Jan  2 10:04 npAu.defectsurface.vtk\r\n-rw-r--r-- 1 me mygroup     3380 Jan  2 10:04 npAu.log\r\n-rw-r--r-- 1 me mygroup   713889 Jan  2 10:04 npAu.dislocations.vtk\r\n-rw-r--r-- 1 me mygroup   666228 Jan  2 10:04 npAu.defectsurfacecap.vtk\r\n\r\n<\/pre>\n","protected":false},"excerpt":{"rendered":"<p>If you are a windows user &#8211; please ensure you create your jobscript ON THE CSF directly using gedit. This will prevent your job going into error (Eqw). Text files created on windows have hidden characters that linux cannot read. For further information please see the guide to using the system from windows, in particular the section about text &amp; batch submission script files. Overview Crystal Analysis Tool is a package for analysing the output.. <a href=\"https:\/\/ri.itservices.manchester.ac.uk\/csf3\/software\/applications\/crystal-analysis-tool\/\">Read more &raquo;<\/a><\/p>\n","protected":false},"author":8,"featured_media":0,"parent":86,"menu_order":0,"comment_status":"closed","ping_status":"closed","template":"","meta":{"footnotes":""},"class_list":["post-1713","page","type-page","status-publish","hentry"],"_links":{"self":[{"href":"https:\/\/ri.itservices.manchester.ac.uk\/csf3\/wp-json\/wp\/v2\/pages\/1713","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/ri.itservices.manchester.ac.uk\/csf3\/wp-json\/wp\/v2\/pages"}],"about":[{"href":"https:\/\/ri.itservices.manchester.ac.uk\/csf3\/wp-json\/wp\/v2\/types\/page"}],"author":[{"embeddable":true,"href":"https:\/\/ri.itservices.manchester.ac.uk\/csf3\/wp-json\/wp\/v2\/users\/8"}],"replies":[{"embeddable":true,"href":"https:\/\/ri.itservices.manchester.ac.uk\/csf3\/wp-json\/wp\/v2\/comments?post=1713"}],"version-history":[{"count":11,"href":"https:\/\/ri.itservices.manchester.ac.uk\/csf3\/wp-json\/wp\/v2\/pages\/1713\/revisions"}],"predecessor-version":[{"id":2625,"href":"https:\/\/ri.itservices.manchester.ac.uk\/csf3\/wp-json\/wp\/v2\/pages\/1713\/revisions\/2625"}],"up":[{"embeddable":true,"href":"https:\/\/ri.itservices.manchester.ac.uk\/csf3\/wp-json\/wp\/v2\/pages\/86"}],"wp:attachment":[{"href":"https:\/\/ri.itservices.manchester.ac.uk\/csf3\/wp-json\/wp\/v2\/media?parent=1713"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}