ChemShell is a computational chemistry environment for standard quantum chemical or force field calculations, including hybrid QM\/MM calculations. ChemShell includes interfaces to various QM and MM codes, and is designed to deal with the communication and data handling, whilst energy evaluations are undertaken by external codes.<\/p>\n
Version 25.0.3 (Python) is the recommended version and has been compiled on the CSF using GCC and OpenMPI and includes links to ORCA and DL_POLY.<\/p>\n
Version 3.7.1 (tcl) has been compiled on the CSF using Intel compilers v17.0.7 and OpenMPI v3.1.1 and has been left available for legacy purposes.<\/p>\n
Version 25.0.3 and later are subject to GNU GPL v3 and are available to all CSF users to use without restriction.<\/p>\n
Please refer to documentation for ORCA<\/a> and DL_POLY<\/a> for further information and license restrictions.<\/p>\n Version 3.7.1 is available for all CSF users to use. Users need to be in the ‘chemshell’ group.<\/p>\n Whilst the software is free for academic usage there are limitations within the licence agreement which must be strictly adhered to by users. The licence covers use on the CSF only. <\/p>\n A full copy of the licence can be found in:<\/p>\n Important points to note are:<\/strong><\/p>\n Users are reminded that they must not share their password with anyone, or allow anyone else to utilise their account.<\/li>\n All users who wish to use the software must request access by contacting us<\/a>.<\/p>\n The Official ChemShell documentation<\/a> provides much more than the basic information below.<\/p>\n To load the module:<\/p>\n Help:<\/p>\n Example Slurm script:<\/p>\n This is provided for legacy information, the Python version of ChemShell is recommended.<\/p>\n To load the module:<\/p>\n ChemShell is normally invoked using the or alternatively by launching the executable with mpirun: <\/p>\n The following Slurm script can be used to submit a single core Chemshell job with input data file test.chm:<\/p>\n A ChemShell script will often use other tools to complete its calculation. For example TurboMole<\/a> and\/or Charmm<\/a> can be started from within your ChemShell script. These tools can often run in parallel. <\/p>\n On the CSF we have found that starting ChemShell in parallel and then trying to run other parallel tools from ChemShell can cause the ChemShell job to crash. The solution is to run ChemShell serially and let it run the other tools in parallel. There are two ways to do this as explained below.<\/p>\n To prevent Chemshell from crashing it should be run serially and then let the other tools (e.g., TurboMole or CHARMM) run in parallel. Hence we still require a PE in the jobscript to specify the number of cores that will be used by the parallel tools. ChemShell can, however, still be run without any MPI commands.<\/p>\n Note that you must<\/em> also load the modulefile for the additional tools ChemShell will use. For example, if calling TurboMole from your ChemShell script you must ensure that you load the required TurboMole modulefile, otherwise ChemShell will not be able to find the additional tools.<\/p>\n The following jobscript sets up a ChemShell job which uses TurboMole to do some processing. TurboMole will run in parallel, but only a single ChemShell process will run. The jobscript is:<\/p>\n Further information can be found on the ChemShell web page<\/a> including the Chemshell Manual, tutorials and details of the chemsh-users<\/em> email list which can be used to post queries to seek help.<\/p>\n","protected":false},"excerpt":{"rendered":" Overview ChemShell is a computational chemistry environment for standard quantum chemical or force field calculations, including hybrid QM\/MM calculations. ChemShell includes interfaces to various QM and MM codes, and is designed to deal with the communication and data handling, whilst energy evaluations are undertaken by external codes. Version 25.0.3 (Python) is the recommended version and has been compiled on the CSF using GCC and OpenMPI and includes links to ORCA and DL_POLY. Version 3.7.1 (tcl).. Read more »<\/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-968","page","type-page","status-publish","hentry"],"_links":{"self":[{"href":"https:\/\/ri.itservices.manchester.ac.uk\/csf3\/wp-json\/wp\/v2\/pages\/968","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=968"}],"version-history":[{"count":20,"href":"https:\/\/ri.itservices.manchester.ac.uk\/csf3\/wp-json\/wp\/v2\/pages\/968\/revisions"}],"predecessor-version":[{"id":12187,"href":"https:\/\/ri.itservices.manchester.ac.uk\/csf3\/wp-json\/wp\/v2\/pages\/968\/revisions\/12187"}],"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=968"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}TCL version<\/h3>\n
\n
\/opt\/apps\/apps\/intel-17.0\/chemshell\/3.7.1\/chemshell_licence.pdf<\/code>.<\/li>\n<\/ul>\n\n
\n
Running ChemShell Python<\/h2>\n
\r\nmodule load apps\/gcc\/chemshell\/py-25.0.3-orca-dlpoly\r\n<\/pre>\n
\r\nchemsh -h\r\n<\/pre>\n
\r\n#!\/bin\/bash --login\r\n#SBATCH -p multicore\r\n#SBATCH -n 2 ## 2 cores, change this for real use\r\n#SBATCH -t 5 ## 5 minutes max, change this for real use \r\n\r\nmodule purge\r\nmodule load apps\/gcc\/chemshell\/py-25.0.3-orca-dlpoly\r\n\r\n## copy a very short example from tutorial to the present working directory\r\ncp $CHEMSH_DOCS\/tutorial\/samples\/single_point\/water.xyz .\r\ncp $CHEMSH_DOCS\/tutorial\/samples\/single_point\/hf_water.orca.py .\r\n\r\n## run example\r\nchemsh -np $NTASKS hf_water.orca.py > hf_water.orca.log\r\n<\/pre>\n
Running ChemShell 3.7.1 (TCL)<\/h2>\n
\r\nmodule load apps\/intel-17.0\/chemshell\/3.7.1\r\n<\/pre>\n
chemsh<\/code> script. By convention input files are suffixed .chm<\/code>, although as is typical for Unix\/Linux applications, the suffix has no significance. Running chemsh<\/code> without an input file will launch an interactive session. Parallel execution can be started using<\/p>\n\r\nchemsh -p $NTASKS input.chm\r\n<\/pre>\n
\r\nmpirun -np $NTASKS chemsh.x input.chm\r\n<\/pre>\n
Serial batch job submission<\/h2>\n
\r\n#!\/bin\/bash --login\r\n#SBATCH -p serial\r\n#SBATCH -t 4-0\r\n\r\n\r\nmodule purge\r\nmodule load apps\/intel-17.0\/chemshell\/3.7.1\r\n\r\nchemsh test.chm\r\n<\/pre>\n
Parallel batch job submission<\/h2>\n
\r\n#!\/bin\/bash --login\r\n#SBATCH -p multicore\r\n#SBATCH -n numcores ## change this\r\n#SBATCH -t 4-0 \r\n\r\nmodule purge\r\nmodule load apps\/intel-17.0\/chemshell\/3.7.1\r\n\r\nchemsh -p $NTASKS prepare.chm\r\n<\/pre>\n
Serial ChemShell calling Parallel QM\/MM Applications<\/h2>\n
Writing your own jobscript<\/h3>\n
\r\n#!\/bin\/bash --login\r\n#SBATCH -p multicore\r\n#SBATCH -n 4 \r\n#SBATCH -t 4-0 \r\n\r\nmodule purge\r\nmodule load apps\/intel-17.0\/chemshell\/3.7.1\r\n\r\n# PARNODES is used by Turbomole - set it to the number above using $NTASKS\r\nexport PARNODES=$NTASKS\r\n\r\n# Run ChemShell serially (without any mpirun)\r\nchemsh myinput.chm >& myoutput.log\r\n<\/pre>\n
Further info<\/h2>\n