Versions 1.3 and 1.4 are installed on the CSF. They have been compiled from source using the Intel v12.0.5 compilers and OpenMPI 1.6.<\/p>\n
Restrictions on use<\/h2>\n
There are no restrictions on accessing this software on the CSF. The software is released under the GNU GPL v2 license. The authors request you cite the use of the software in your publications – please see the Relion website<\/a> for details.<\/p>\n To access the software you must first load one<\/strong> of the following modulefiles, according to whether you wish to run on Ethernet networked nodes (also if using single node SMP jobs) or InfiniBand networked nodes (faster networking for multi-node jobs):<\/p>\n These modulefiles will load automatically the compiler and MPI modulefiles for you.<\/p>\n Relion can be run with a GUI on the login node. This is mainly used to select input files and set up job parameters. The GUI will then submit your job to the batch queues.<\/p>\n Users must always<\/em> run the main processing in batch<\/strong> (where the GUI permits submission to the batch system), never directly on the login node. This requires correct settings in the GUI, as instructed below. <\/p>\n Relion tools other than the GUI found running on the login node will be terminated without warning<\/em> and access to the GUI may be withdrawn.<\/p>\n Please note, a tutorial on using Relion to process your data is beyong the scope of this page, which only describes how to run the application on the CSF. Please follow the Relion Turorial (pdf)<\/a> on the Relion website if you are new to the software.<\/p>\n Once the modulefile file is loaded you should navigate to your Relion project directory (this is important – it will usually contain a It will display the following GUI (click on image to enlarge): Various operations can be performed by selecting from the list on the left hand side (Micrograph inspection, CTF estimation and so on). These operations allow you to specify use of the batch system, as detailed below.<\/p>\n Note: To re-activate a greyed-out Each Relion processing operation (Micrograph inspection, CTF estimation etc) has a Running<\/em> tab in its GUI page. There are three possible types of Running<\/em> tab:<\/p>\n Once you have set the Running<\/em> tab options as indicated above press the The auto-generated jobscript will be written to your current directory (your Relion project directory) and will be named similar to the operation being performed with a The usual output and error output from the job will be written to files with This section is for advanced users familiar with Relion and the CSF batch system. In most cases the default settings will work for you and you should not need to follow this section.<\/p>\n Relion auto-generates jobscripts by filling in place-holders in a qsub template file<\/em> named The default template file contains:<\/p>\n The Alternatively you may want to add other commands to the jobscript, for example:<\/p>\n If you wish to submit a batch job manually<\/em> from the command-line (using your own batch script) in the traditional CSF manner, then you can ask Relion to display the command it will use in its auto-generated jobscript. <\/p>\n Start the Relion GUI, select the operation to perform (e.g., 2D Classification), select the Running<\/em> tab, make any changes to the settings then press the For example, the following is displayed for the 2D Classification example above<\/em>:<\/p>\n Hence you can write your own jobscript to run this command. Ensure that you add the usual Notice that we have added You should then submit your jobscript using the usual where myjobscript<\/em> is the name of your jobscript.<\/p>\n None.<\/p>\n","protected":false},"excerpt":{"rendered":" Overview Relion is program that employs an empirical Bayesian approach to refinement of (multiple) 3D reconstructions or 2D class averages in electron cryo-microscopy (cryo-EM). It is developed in the group of Sjors Scheres at the MRC Laboratory of Molecular Biology. Versions 1.3 and 1.4 are installed on the CSF. They have been compiled from source using the Intel v12.0.5 compilers and OpenMPI 1.6. Restrictions on use There are no restrictions on accessing this software on.. Read more »<\/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-1816","page","type-page","status-publish","hentry"],"_links":{"self":[{"href":"https:\/\/ri.itservices.manchester.ac.uk\/csf-apps\/wp-json\/wp\/v2\/pages\/1816","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=1816"}],"version-history":[{"count":20,"href":"https:\/\/ri.itservices.manchester.ac.uk\/csf-apps\/wp-json\/wp\/v2\/pages\/1816\/revisions"}],"predecessor-version":[{"id":4106,"href":"https:\/\/ri.itservices.manchester.ac.uk\/csf-apps\/wp-json\/wp\/v2\/pages\/1816\/revisions\/4106"}],"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=1816"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}Set up procedure<\/h2>\n
\r\n# Multi-node job (using all cores on the nodes) with fast InfiniBand networking\r\nmodule load apps\/intel-12.0\/relion\/2.0.3-ib\r\nmodule load apps\/intel-12.0\/relion\/1.4-ib\r\nmodule load apps\/intel-12.0\/relion\/1.3-ib\r\n\r\n# Single-node multicore job\r\nmodule load apps\/intel-12.0\/relion\/2.0.3\r\nmodule load apps\/intel-12.0\/relion\/1.4\r\nmodule load apps\/intel-12.0\/relion\/1.3\r\n<\/pre>\n
Running the application<\/h2>\n
Running the GUI<\/h3>\n
Micrographs<\/code> subdirectory) and then run relion<\/code> on the login node. For example:<\/p>\n\r\ncd ~\/scratch\/my_relion_project\/\r\nrelion\r\n<\/pre>\n
\n![\"Relion](\"https:\/\/ri.itservices.manchester.ac.uk\/csf-apps\/wp-content\/uploads\/relion-general.png\")
<\/a><\/p>\nRun<\/code> button, press Alt+R<\/code> in the GUI.<\/p>\nUsing the GUI to run in Batch<\/h3>\n
\n
\n![\"Relion](\"https:\/\/ri.itservices.manchester.ac.uk\/csf-apps\/wp-content\/uploads\/relion-micrograph-running-red.png\")
<\/a><\/li>\n
\n![\"Relion](\"https:\/\/ri.itservices.manchester.ac.uk\/csf-apps\/wp-content\/uploads\/relion-ctfest-running-red.png\")
<\/a> The options should be set as follows:<\/p>\n\n
smp.pe<\/code> for single node jobs (2-24 cores) or orte-24-ib.pe<\/code> for multi-node jobs (48 or more cores and in multiples of 24, ensure you have loaded the relion -ib<\/code> modulefile).<\/li>\nqsub<\/code><\/li>\n\/opt\/gridware\/apps\/intel-12.0\/relion\/version<\/em>\/bin\/qsub.sh<\/pre>\n<\/li>\n
\n![\"Relion](\"https:\/\/ri.itservices.manchester.ac.uk\/csf-apps\/wp-content\/uploads\/relion-2Dclass-running-red.png\")
<\/a> The options should be set as follows:<\/p>\n\n
smp.pe<\/code> for single node jobs (2-24 cores) or orte-24-ib.pe<\/code> for multi-node jobs (48 or more cores and in multiples of 24, ensure you have loaded the relion -ib<\/code> modulefile).<\/li>\nqsub<\/code><\/li>\n\/opt\/gridware\/apps\/intel-12.0\/relion\/version<\/em>\/bin\/qsub.sh<\/pre>\n<\/li>\n
Submitting the Batch Job from the GUI<\/h3>\n
Run!<\/code> button to submit an auto-generated jobscript to the batch system. It may appear that nothing has happened when you do this. However, you should check on the job using the usual qstat<\/code> command by running it in a command-line window on the CSF. It will report whether your job is queued or running. If you see no output then you job has finished (either successfully or because an error occurred).<\/p>\n.script<\/code> extension. For example:<\/p>\n\r\nrun_ctffind_submit.script\r\n<\/pre>\n
.out<\/code> and .err<\/code> extensions respectively. You should check these for further information about your job. For example:<\/p>\n\r\nrun_ctffind.out\r\nrun_ctffind.err\r\n<\/pre>\n
Summary<\/h3>\n
\n
qstat<\/code> in a terminal window on the CSF.<\/li>\n<\/ul>\nAdvanced: Custom Batch Script Template<\/h2>\n
qsub.sh<\/code>. It is possible for you to take a copy of this file, modify it and have Relion use your new template each time you submit a job via the Relion GUI. The following steps are required:<\/p>\n\n
\r\ncp $RELION_QSUB_TEMPLATE ~\/my_relion_project\/\r\n<\/pre>\n<\/li>\n
\r\ngedit ~\/my_relion_project\/qsub.sh\r\n<\/pre>\n<\/li>\n
\r\nexport RELION_QSUB_TEMPLATE=~\/my_relion_project\/qsub.sh\r\n<\/pre>\n<\/li>\n
\r\nrelion\r\n<\/pre>\n<\/li>\n<\/ol>\n
\r\n#!\/bin\/bash\r\n#$ -pe XXXqueueXXX XXXmpinodesXXX\r\n#$ -e XXXerrfileXXX\r\n#$ -o XXXoutfileXXX\r\n#$ -cwd\r\n#$ -S \/bin\/bash\r\n#$ -V\r\n\r\nmpiexec -n XXXmpinodesXXX XXXcommandXXX\r\n<\/pre>\n
XXX.....XXX<\/code> keywords are the place-holders that will be replaced with the settings you specify in the Relion GUI. You should leave the -pe<\/code> setting as is. However, you may wish to add other CSF options<\/a> such as<\/p>\n\r\n#$ -l twoday # Run in two-day area of the CSF\r\n#$ -m ea # Email me when job ends or aborts\r\n<\/pre>\n
\r\n# Report the date before running\r\ndate\r\nmpiexec -n XXXmpinodesXXX XXXcommandXXX\r\n<\/pre>\n
Advanced: Hand-crafting Jobscripts<\/h2>\n
Print command<\/code> button to display in your shell window what Relion uses in its jobscript. <\/p>\n\r\n`which relion_refine_mpi` --o Class2D\/run1 --i --particle_diameter 200 \\\r\n--angpix 3.54 --ctf --iter 25 --tau2_fudge 2 --K 1 --flatten_solvent \\\r\n--zero_mask --oversampling 1 --psi_step 10 --offset_range 5 --offset_step 2 \\\r\n--norm --scale --j 1 --memory_per_thread 4 \r\n<\/pre>\n
mpirun<\/code> command and specify the correct number of cores. For example:<\/p>\n\r\n#!\/bin\/bash\r\n#$ -S bash\r\n#$ -cwd # Run from current directory\r\n#$ -V # Inherit modulefile settings\r\n#$ -pe smp.pe 8 # We'll use 8 cores (single-node)\r\n\r\n# We must add the usual mpirun command as used in many CSF jobscripts\r\n\r\nmpirun -n $NSLOTS<\/strong> `which relion_refine_mpi` --o Class2D\/run1 --i \\\r\n--particle_diameter 200 --angpix 3.54 --ctf --iter 25 --tau2_fudge 2 --K 1 \\\r\n--flatten_solvent --zero_mask --oversampling 1 --psi_step 10 --offset_range 5 \\\r\n--offset_step 2 --norm --scale --j 1 --memory_per_thread 4 \r\n\r\n# We can add any other commands we wish to run from the jobscript. EG:\r\ndate\r\n<\/pre>\n
mpirun -n $NSLOTS<\/code> to the start of the command that Relion reported. Relion will automatically add this when it auto-generates a jobscript.<\/p>\nqsub<\/code> command:<\/p>\n\r\nqsub myjobscript<\/em>\r\n<\/pre>\n
Further info<\/h2>\n
\n
Updates<\/h2>\n