HPC

Difference between revisions of "Applications/Stata"

From HPC
Jump to: navigation , search
m
(→‎Application Details)
 
(30 intermediate revisions by 2 users not shown)
Line 2: Line 2:
 
== Application Details ==
 
== Application Details ==
  
−
* Description : Stata is a commercial statistical package, which provides a complete solution for data analysis, data management, and graphics.  Stata version 14 is available in the multi-threaded package variant Stata/MP.
+
* Description : Stata is a commercial statistical package, which provides a complete solution for data analysis, data management, and graphics.   
−
* Versions : 14.1.0
+
* Versions : Stata/SE/14.1.0, Stata/SE/15.0, Stata/SE/17.0
−
* Module names : stata/14.1.0
+
* Module names : stata/SE/14.1.0, stata/SE/15.0, stata/SE/17.0
−
* License: University of Hull, presently unavailable
+
* License: University of Hull, Viper usage is restricted to two concurrent seats. When using Stata/SE on Viper you '''must''' request the appropriate license either from the command line (''interactive session'') or as part of your batch script (''batch mode''), [[#Interactive|see below]]:
  
 +
== License ==
 +
There are two licenses for Stata/SE that have been made available on Viper. In order to ensure correct license usage, it is important to request a license as detailed in the usage examples below. If no licenses are available, a job will be held pending until a license becomes available, with squeue showing a pend reason of ''(Licenses)'':
  
 +
<pre style="background-color: #000000; color: white; border: 2px solid black; font-family: monospace, sans-serif;">
 +
              JOBID    PARTITION NAME      USER    ST      TIME  NODES NODELIST(REASON)
 +
              2521112  compute  Statajob4  username PD      0:00      1 (Licenses)
 +
              2531111  compute  Statajob3  username PD      0:00      1 (Licenses)
 +
              2531110  compute  Statajob2  username R        2:48      1 c171
 +
              2531109  compute  Statajob1  username R        4:48      1 c171
 +
</pre>
  
−
== Toolboxes ==
+
You can check on current license usage by running the following command:
  
−
No toolboxes are loaded
+
<pre style="background-color: #000000; color: white; border: 2px solid black; font-family: monospace, sans-serif;">
 +
[username@login01 ~]$ scontrol show lic
 +
LicenseName=statase
 +
    Total=2 Used=1 Free=1 Remote=no
 +
</pre>
  
 
== Usage Examples ==
 
== Usage Examples ==
 +
=== Executables ===
 +
{| class="wikitable" style="background-color:#f5f5dc;"
 +
! Executable
 +
! Description
 +
|-
 +
| stata-se
 +
| Non-graphical Stata/SE designed for large databases, which can be used interactively through the terminal, or be used to run tasks automatically with the ''batch'' flag -b and a Stata do file.
 +
|-
 +
| stata
 +
| Non-graphical Stata/IC which is the standard version of Stata. '''Note:''' For better performance and support for larger databases, stata-se should be used.
 +
|-
 +
| xstata-se
 +
| Graphical version of Stata/SE, which can be used interactively in a similar working environment to Windows and Mac versions.
 +
|-
 +
| xstata
 +
| Graphical version of Stata/IC which is the standard version of Stata. '''Note:''' For better performance and support for larger databases, xstata-se should be used.
 +
|}
 +
 +
=== Interactive ===
 +
When running Stata/SE interactively, it is important to request the appropriate license by starting an interactive session in the following way:
 +
<pre style="background-color: #000000; color: white; border: 2px solid black; font-family: monospace, sans-serif;">
 +
[username@login01 ~]$ interactive -L statase:1
 +
</pre>
 +
 +
Interactive with full graphical interface:
 +
<pre style="background-color: #000000; color: white; border: 2px solid black; font-family: monospace, sans-serif;">
 +
[username@login01 ~]$ interactive -L statase:1
 +
salloc: Granted job allocation 289661
 +
Job ID 289661 connecting to c174, please wait...
 +
Last login: Thu Jan 26 12:59:11 2017 from 10.254.5.246
 +
[username@c174 ~]$ module add stata/SE/14.1.0
 +
[username@c174 ~]$ xstata-se
 +
</pre>
 +
[[File:Xstata-se.PNG]]
 +
 +
Interactive with command line only:
 +
<pre style="background-color: #000000; color: white; border: 2px solid black; font-family: monospace, sans-serif;">
 +
[username@login01 ~]$ interactive -L statase:1
 +
salloc: Granted job allocation 289663
 +
Job ID 289663 connecting to c170, please wait...
 +
Last login: Thu Jan 26 12:59:11 2017 from 10.254.5.246
 +
[username@c170 ~]$ stata-se
 +
 +
  ___  ____  ____  ____  ____ (R)
 +
/__    /  ____/  /  ____/
 +
___/  /  /___/  /  /___/  14.1  Copyright 1985-2015 StataCorp LP
 +
  Statistics/Data Analysis            StataCorp
 +
                                      4905 Lakeway Drive
 +
    Special Edition                  College Station, Texas 77845 USA
 +
                                      800-STATA-PC        http://www.stata.com
 +
                                      979-696-4600        stata@stata.com
 +
                                      979-696-4601 (fax)
 +
 +
50-user Stata network license expires 14 Nov 2017:
 +
      Serial number:  #############
 +
        Licensed to:  HULL IT
 +
                      University of Hull
 +
 +
Notes:
 +
      1.  Unicode is supported; see help unicode_advice.
 +
      2.  Maximum number of variables is set to 5000; see help set_maxvar.
 +
 +
.
 +
</pre>
 +
 +
=== Batch Submission ===
 +
<pre style="background-color: #C8C8C8; color: black; font-family: monospace, sans-serif;">
 +
#!/bin/bash
 +
#SBATCH -J Stata          # Job name, you can change it to whatever you want
 +
#SBATCH -N 1              # Number of nodes (for Stata/SE should be always one)
 +
#SBATCH -o %N.%j.out      # Standard output will be written here
 +
#SBATCH -e %N.%j.err      # Standard error will be written here
 +
#SBATCH -p compute        # Slurm partition, where you want the job to be queued
 +
#SBATCH -L statase:1      # Use 1 Stata/SE license (this MUST be included in State/SE job scripts
 +
module purge
 +
module add stata/SE/14.1.0
 +
 +
stata-se -b do testid.do
 +
</pre>
 +
 +
<pre style="background-color: #000000; color: white; border: 2px solid black; font-family: monospace, sans-serif;">
 +
[username@login01 ~]$ sbatch STATAtest.job
 +
Submitted batch job 289529
 +
</pre>
  
 
=== Test Program ===
 
=== Test Program ===
−
 
 
Below is a test example Stata batch file for submission to VIPER called <strong>testit.do</strong>
 
Below is a test example Stata batch file for submission to VIPER called <strong>testit.do</strong>
  
−
<pre style="background-color: #C8C8C8; color: black; border: 2px solid black; font-family: monospace, sans-serif;">
+
<pre style="background-color: #f5f5dc; color: black; font-family: monospace, sans-serif;">
−
 
 
 
clear*
 
clear*
 
set rmsg on
 
set rmsg on
Line 36: Line 131:
 
*with bootstrap:
 
*with bootstrap:
 
qui bs, reps(1000): logit dv i*
 
qui bs, reps(1000): logit dv i*
−
 
−
</pre>
 
−
 
−
 
−
=== Batch Submission ===
 
−
 
−
<pre style="background-color: #C8C8C8; color: black; border: 2px solid blue; font-family: monospace, sans-serif;">
 
−
 
−
#!/bin/bash
 
−
 
−
#SBATCH -J StataMP-20
 
−
#SBATCH -N 1
 
−
#SBATCH --ntasks-per-node=20
 
−
 
−
#SBATCH -o test.out
 
−
#SBATCH -e test.err
 
−
#SBATCH -p compute
 
−
#SBATCH --exclusive
 
−
#SBATCH --time=2-00:00:00
 
−
 
−
echo $SLURM_NTASKS
 
−
echo $SLURM_JOB_NODELIST
 
−
echo $SLURM_HOSTS
 
−
 
−
module purge
 
−
module load stata/14.1.0
 
−
 
−
stata-mp -s do testit.do
 
−
 
−
</pre>
 
−
 
−
 
−
<pre style="background-color: black; color: white; border: 2px solid black; font-family: monospace, sans-serif;">
 
−
[username@login01 ~]$ sbatch stata-mp.job
 
−
Submitted batch job 389522
 
 
</pre>
 
</pre>
  
Line 77: Line 137:
 
* [http://www.stata.com/ http://www.stata.com/]
 
* [http://www.stata.com/ http://www.stata.com/]
  
−
 
+
{{Licensepagenav}}
−
[[Category:Applications]]
 

Latest revision as of 19:56, 1 June 2023

Application Details

  • Description : Stata is a commercial statistical package, which provides a complete solution for data analysis, data management, and graphics.
  • Versions : Stata/SE/14.1.0, Stata/SE/15.0, Stata/SE/17.0
  • Module names : stata/SE/14.1.0, stata/SE/15.0, stata/SE/17.0
  • License: University of Hull, Viper usage is restricted to two concurrent seats. When using Stata/SE on Viper you must request the appropriate license either from the command line (interactive session) or as part of your batch script (batch mode), see below:

License

There are two licenses for Stata/SE that have been made available on Viper. In order to ensure correct license usage, it is important to request a license as detailed in the usage examples below. If no licenses are available, a job will be held pending until a license becomes available, with squeue showing a pend reason of (Licenses): 

               JOBID     PARTITION NAME       USER     ST       TIME  NODES NODELIST(REASON)
               2521112   compute   Statajob4  username PD       0:00      1 (Licenses)
               2531111   compute   Statajob3  username PD       0:00      1 (Licenses)
               2531110   compute   Statajob2  username R        2:48      1 c171
               2531109   compute   Statajob1  username R        4:48      1 c171

You can check on current license usage by running the following command: 

[username@login01 ~]$ scontrol show lic
LicenseName=statase
    Total=2 Used=1 Free=1 Remote=no

Usage Examples

Executables

Executable Description
stata-se Non-graphical Stata/SE designed for large databases, which can be used interactively through the terminal, or be used to run tasks automatically with the batch flag -b and a Stata do file.
stata Non-graphical Stata/IC which is the standard version of Stata. Note: For better performance and support for larger databases, stata-se should be used.
xstata-se Graphical version of Stata/SE, which can be used interactively in a similar working environment to Windows and Mac versions.
xstata Graphical version of Stata/IC which is the standard version of Stata. Note: For better performance and support for larger databases, xstata-se should be used.

Interactive

When running Stata/SE interactively, it is important to request the appropriate license by starting an interactive session in the following way: 

[username@login01 ~]$ interactive -L statase:1

Interactive with full graphical interface: 

[username@login01 ~]$ interactive -L statase:1
salloc: Granted job allocation 289661
Job ID 289661 connecting to c174, please wait...
Last login: Thu Jan 26 12:59:11 2017 from 10.254.5.246
[username@c174 ~]$ module add stata/SE/14.1.0
[username@c174 ~]$ xstata-se

Xstata-se.PNG

Interactive with command line only: 

[username@login01 ~]$ interactive -L statase:1
salloc: Granted job allocation 289663
Job ID 289663 connecting to c170, please wait...
Last login: Thu Jan 26 12:59:11 2017 from 10.254.5.246
[username@c170 ~]$ stata-se

  ___  ____  ____  ____  ____ (R)
 /__    /   ____/   /   ____/
___/   /   /___/   /   /___/   14.1   Copyright 1985-2015 StataCorp LP
  Statistics/Data Analysis            StataCorp
                                      4905 Lakeway Drive
     Special Edition                  College Station, Texas 77845 USA
                                      800-STATA-PC        http://www.stata.com
                                      979-696-4600        [mailto:stata@stata.com stata@stata.com]
                                      979-696-4601 (fax)

50-user Stata network license expires 14 Nov 2017:
       Serial number:  #############
         Licensed to:  HULL IT
                       University of Hull

Notes:
      1.  Unicode is supported; see help unicode_advice.
      2.  Maximum number of variables is set to 5000; see help set_maxvar.

.

Batch Submission

#!/bin/bash
#SBATCH -J Stata           # Job name, you can change it to whatever you want
#SBATCH -N 1               # Number of nodes (for Stata/SE should be always one)
#SBATCH -o %N.%j.out       # Standard output will be written here
#SBATCH -e %N.%j.err       # Standard error will be written here
#SBATCH -p compute         # Slurm partition, where you want the job to be queued 
#SBATCH -L statase:1       # Use 1 Stata/SE license (this MUST be included in State/SE job scripts 
module purge
module add stata/SE/14.1.0
 
stata-se -b do testid.do

[username@login01 ~]$ sbatch STATAtest.job
Submitted batch job 289529

Test Program

Below is a test example Stata batch file for submission to VIPER called testit.do 

clear*
set rmsg on
set obs 1000000
forval n = 1/10 {
g i`n' = runiform()
}
g dv = rbinomial(1,.3)
memory

qui logit dv i*

qui xtmixed dv i*

*with bootstrap:
qui bs, reps(1000): logit dv i*

Further Information





Special License Applications | Main Page | Further Topics

Retrieved from ‘http://hpc.mediawiki.hull.ac.uk/index.php?title=Applications/Stata&oldid=41600’