{"id":2962,"date":"2019-04-02T11:50:53","date_gmt":"2019-04-02T10:50:53","guid":{"rendered":"http:\/\/ri.itservices.manchester.ac.uk\/csf3\/?page_id=2962"},"modified":"2026-11-12T17:53:17","modified_gmt":"2026-11-12T17:53:17","slug":"macs","status":"publish","type":"page","link":"https:\/\/ri.itservices.manchester.ac.uk\/csf3\/software\/applications\/macs\/","title":{"rendered":"MACS"},"content":{"rendered":"<h2>Overview<\/h2>\n<p><a href=\"https:\/\/macs3-project.github.io\/MACS\">Model-based Analysis of ChIP-Seq<\/a> (MACS3)<\/p>\n<h2>Restrictions on use<\/h2>\n<p>MACS is open source software and available to all users of the system. It is released under the <a href=\"https:\/\/github.com\/macs3-project\/MACS\/blob\/main\/LICENSE\">BSD 3-Clause License<\/a> and all usage must adhere to that license.<\/p>\n<p>Please ensure you cite your usage in any results and publications, as described in:<\/p>\n<ul>\n<li><a href=\"https:\/\/github.com\/macs3-project\/MACS\/tree\/main#citation\">the project&#8217;s source repository<\/a><\/li>\n<p>OR<\/p>\n<li><a href=\"https:\/\/macs3-project.github.io\/MACS\/index.html#ackowledgement\">the project&#8217;s documentation page<\/a><\/li>\n<\/ul>\n<h2>Set up procedure<\/h2>\n<p>We now recommend loading modulefiles within your jobscript so that you have a full record of how the job was run. See the example jobscript below for how to do this.<\/p>\n<pre>\r\n# MACS3\r\nmodule load apps\/python\/macs\/3.1.0   # Python 3.14 (extensions compiled with GCC 14.2.0)\r\n\r\n# MACS2 Python3-based versions\r\nmodule load apps\/python\/macs2\/2.2.5\r\n\r\n# MACS2 Python2-based versions\r\nmodule load apps\/python\/macs2\/2.1.3.3\r\n<\/pre>\n<p>This will also automatically load the required version of python for you.<\/p>\n<p>Below are legacy versions no longer supported on the CSF3. Try the <a href=\"..\/bioinf\/\">Bio-informatics Helper Modulefile<\/a> if you <em>really<\/em> have to use them.<\/p>\n<pre>\r\nmodule load apps\/macs\/2.1.2\r\nmodule load apps\/macs\/2.1.1.20160309\r\nmodule load apps\/macs\/2.1.0.20150731\r\nmodule load apps\/macs\/2.1.0.20150420\r\nmodule load apps\/macs\/2.1.0\r\n<\/pre>\n<h2>Running the application<\/h2>\n<p>Please do not run MACS on the login node. Jobs should be submitted to the compute nodes via batch.<\/p>\n<p>You <em>may<\/em> run the following command on the login node to get some help with running MACS:<\/p>\n<pre>\r\nmacs3 -h      # for MACS3\r\nmacs2 -h      # for MACS2\r\n<\/pre>\n<p>This will show the list of available commands (algorithms) that can be run:<\/p>\n<pre>\r\ncallpeak, bdgpeakcall, bdgbroadcall, bdgcmp,\r\nbdgopt,   cmbreps,     bdgdiff,      filterdup,\r\npredictd, pileup,      randsample,   refinepeak\r\ncallvar, hmmratac\r\n<\/pre>\n<p>To get help with each individual command, run:<\/p>\n<pre>\r\nmacs3 <em>command<\/em> -h\r\n# OR\r\nmacs2 <em>command<\/em> -h\r\n<\/pre>\n<h3>Serial batch job submission<\/h3>\n<p>Create a batch submission script (which will load the modulefile in the jobscript), for example:<\/p>\n<pre>\r\n#!\/bin\/bash --login\r\n#SBATCH -p serial\r\n#SBATCH -t 0-6\r\n\r\n# We recommend loading modulefiles in jobscripts. Use your required version.\r\nmodule purge\r\nmodule load apps\/python\/macs\/3.1.0\r\n\r\nmacs3 <em>command<\/em> <em>arg1 arg2 ...<\/em> --threads $SLURM_CPUS_PER_TASK\r\n<\/pre>\n<p>Submit the jobscript using: <\/p>\n<pre>sbatch <em>scriptname<\/em><\/pre>\n<p>where <em>scriptname<\/em> is the name of your jobscript.<\/p>\n<h3>Parallel batch job submission<\/h3>\n<p>More info on parallel execution is available in the <a href=\"https:\/\/macs3-project.github.io\/MACS\/docs\/execution.html\">official documentation<\/a>.<\/p>\n<p>Jobscript example:<\/p>\n<pre>\r\n#!\/bin\/bash --login\r\n#SBATCH -p multicore_small\r\n#SBATCH -t 0-6\r\n#SBATCH -c 8\r\n\r\nmodule purge\r\nmodule load apps\/python\/macs\/3.1.0\r\n\r\nmacs3 <em>command<\/em> <em>arg1 arg2 ...<\/em> --threads $SLURM_CPUS_PER_TASK\r\n<\/pre>\n<p>Submit the jobscript using: <\/p>\n<pre>sbatch <em>scriptname<\/em><\/pre>\n<p>where <em>scriptname<\/em> is the name of your jobscript.<\/p>\n<h2>Installation in a conda environment<\/h2>\n<p>If a newer or older version of MACS is required, it can be easily installed in a <a href=\"..\/conda\/#Create_a_Conda_environment\">conda environment<\/a> in your home directory. Here is an example of commands to follow:<\/p>\n<pre>\r\nmodule load apps\/binapps\/conda\/miniforge3\/26.9.4-0-w-mamba \r\nconda create --name <em>macs3_env<\/em> --strict-channel-priority macs3\r\n# Answer y (for yes) when prompted\r\nconda activate <em>macs3_env<\/em>\r\nmacs3 -h\r\n<\/pre>\n<p>Then inside your jobscript, you would also need to add the following line &#8211; just after loading the miniforge module &#8211; to activate your environment:<\/p>\n<pre>\r\nconda activate <em>macs3_env<\/em>\r\n<\/pre>\n<h2>Further info<\/h2>\n<ul>\n<li><a href=\"https:\/\/macs3-project.github.io\/MACS\">MACS website<\/a><\/li>\n<li><a href=\"https:\/\/github.com\/macs3-project\/MACS\">MACS Github source code Repository<\/a><\/li>\n<li><a href=\"https:\/\/pypi.python.org\/pypi\/MACS2\">MACS2 on pypi<\/a><\/li>\n<li><a href=\"https:\/\/pypi.python.org\/pypi\/MACS3\">MACS3 on pypi<\/a><\/li>\n<\/ul>\n<h2>Updates<\/h2>\n<p>None.<\/p>\n","protected":false},"excerpt":{"rendered":"<p>Overview Model-based Analysis of ChIP-Seq (MACS3) Restrictions on use MACS is open source software and available to all users of the system. It is released under the BSD 3-Clause License and all usage must adhere to that license. Please ensure you cite your usage in any results and publications, as described in: the project&#8217;s source repository OR the project&#8217;s documentation page Set up procedure We now recommend loading modulefiles within your jobscript so that you.. <a href=\"https:\/\/ri.itservices.manchester.ac.uk\/csf3\/software\/applications\/macs\/\">Read more &raquo;<\/a><\/p>\n","protected":false},"author":1,"featured_media":0,"parent":86,"menu_order":0,"comment_status":"closed","ping_status":"closed","template":"","meta":{"footnotes":""},"class_list":["post-2962","page","type-page","status-publish","hentry"],"_links":{"self":[{"href":"https:\/\/ri.itservices.manchester.ac.uk\/csf3\/wp-json\/wp\/v2\/pages\/2962","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\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/ri.itservices.manchester.ac.uk\/csf3\/wp-json\/wp\/v2\/comments?post=2962"}],"version-history":[{"count":15,"href":"https:\/\/ri.itservices.manchester.ac.uk\/csf3\/wp-json\/wp\/v2\/pages\/2962\/revisions"}],"predecessor-version":[{"id":13047,"href":"https:\/\/ri.itservices.manchester.ac.uk\/csf3\/wp-json\/wp\/v2\/pages\/2962\/revisions\/13047"}],"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=2962"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}