====== Stata MP Help ======

Stata/MP is the multiprocessor version of [[https://www.stata.com/why-use-stata/who-uses-stata/|Stata]], used for modelling and analysis of large datasets, predominantly in social sciences.

Stata/MP is available as the **2-core** version on our HPC facilities as part of our University licensing agreement. It is available to all users.

You can run Stata MP on Comet in batch mode - recommended for scripting users, or when using multiple servers:  

  * Batch mode: https://www.stata.com/support/faqs/unix/batch-mode/ 
  * For more information:  https://www.stata.com/statamp/

----
===== Running Stata/MP on Comet using interactive mode=====

Load the "Stata" module

<code lang=bash>
$ module load Stata
</code>

Using Stata/MP in interactive mode (Note that interactive mode only supports the use of limited hardware resources, so batch mode is recommended)

<code lang=bash>
$ stata-mp
</code>

<WRAP round box important half>
Remember that intensive or long running tasks should //not// be run on the Comet login nodes, so limit your interactive use to short test cases only.
</WRAP>

----
===== Running Stata/MP on Comet using batch mode =====

To use Stata/MP in batch mode and run a Stata do-file job, add the following command in your Slurm [[https://hpc.researchcomputing.ncl.ac.uk/dokuwiki/doku.php?id=started:first_job|SBATCH]] file

<code lang=bash>
module load Stata
stata-mp -b mydofile.do
</code>

Then you can submit the job normally using the ''sbatch'' command. If doing so, remember that the license for Stata/MP restricts it to two CPU cores //maximum//.

----

[[:advanced:software_list|Back to Software List]]