User’s Guide for Windows with Stata, SAS, R, and …

User¡¯s Guide for Windows with Stata, SAS, R, and Python

StatTag Windows Version 6.0 User¡¯s Guide

Table of Contents

1.0

Introduction ..................................................................................................................................... 4

2.0

Setup ................................................................................................................................................ 4

3.0

Basics of StatTag .............................................................................................................................. 6

3.1

StatTag Elements ............................................................................................................................. 6

3.2

Navigating StatTag for Windows ..................................................................................................... 7

3.3

Interacting with the StatTag for Windows interface ..................................................................... 10

3.4

Managing Tags ............................................................................................................................... 13

4.0

Defining Tags ................................................................................................................................. 14

4.1

Structure ........................................................................................................................................ 14

4.2

Syntax ............................................................................................................................................ 17

4.3

Process ........................................................................................................................................... 18

5.0

Formatting tags.............................................................................................................................. 22

5.1

Values ............................................................................................................................................ 22

5.2

Tables ............................................................................................................................................. 22

5.3

Formatting after insertion ............................................................................................................. 23

6.0

Troubleshooting............................................................................................................................. 23

7.0

Acknowledgements ....................................................................................................................... 30

Appendix A. Licenses ................................................................................................................................. 31

Appendix B. Frequently Asked Questions.................................................................................................. 41

2|Page

StatTag Windows Version 6.0 User¡¯s Guide

Let¡¯s Stay in Touch!

The StatTag team appreciates all feedback and would love to hear from you!

In particular:

1. Did you find StatTag easy to use? Was it intuitive?

2. Did StatTag function as expected? Were you able to incorporate your working statistical

package code? Were you able to tag documents?

3. Did you encounter any errors? If so, what happened? Can you tell us how to reproduce

them?

Please email your feedback to: StatTag@northwestern.edu

You can also reach us on Twitter:

Open and Free

StatTag is open source and provided for free, courtesy of Northwestern University under a grant

by the National Institutes of Health.

Visit us on GitHub:

3|Page

StatTag Windows Version 6.0 User¡¯s Guide

Introduction

1.0

StatTag is user-friendly software that integrates statistical code with document preparation in Microsoft

Word. StatTag facilitates reproducible research by connecting Word documents, such as a manuscript,

to associated statistical code. Word documents prepared with StatTag are reproducible dynamic

documents: statistical results in the document can be automatically updated if either statistical code or

data change. In addition, StatTag allows statistical code to be edited directly from Microsoft Word.

StatTag is provided as a free Word plug-in written in C#. Once installed, StatTag is accessible from the

Word toolbar. This user¡¯s guide covers use of StatTag within a Windows environment for Microsoft

Word partnered with:

? Stata (StataCorp. 2015. Stata Statistical Software: Release 14. College Station, TX: StataCorp LP)

? SAS (SAS. 2002-2012. SAS Institute Inc: Release 9.4. Cary, NC)

? R (R Foundation for Statistical Computing. 2015. R version 3.0 Vienna, Austria)

? R Markdown (R Studio. 2016. R Studio Inc.: R version 3.0 Vienna, Austria)

? Python (Python Software Foundation. 2008. Python version 3.5. Wilmington, DE)

Requirements

StatTag requires the following

?

?

?

Windows 7 and above

Microsoft Word 2016 and above

One or more supported statistical applications

o Stata 13 and above

o SAS 9.4

o R 3.3 - 4.0.2*

o R Markdown (R Studio, R)

o Python 3.5 and above

* - See Appendix B for more information about R compatibility

2.0

Setup

1. Download the StatTag software file at

2. Install the software by clicking ¡°Run¡± when prompted, and follow the InstallShield Wizard.

3. Open Microsoft Word. If StatTag has installed successfully, your Word toolbar will include a

¡°StatTag¡± tab that will look like this:

4|Page

StatTag Windows Version 6.0 User¡¯s Guide

Steps 4-8 are for Stata users ONLY

4. Select the ¡°StatTag¡± tab on the top tool bar.

5. Select the ¡°User Settings¡± icon

6. Enable the Stata API through the Stata tab. Enter the file path for Stata on your computer. This

may be something like C:\Program Files (x86)\Stata15\StataSE-64.exe.

Tip: To locate the file path of your Stata program, open Stata, and type ¡®sysdir¡¯ in the command

line. This returns the installation pathway. Open the folder in Windows Explorer to verify the

pathway and identify the name of your Stata executable (.exe) file.

7. Click ¡®Enable Automation¡¯ after the file path has been set to allow StatTag and Stata to

communicate via the Stata Automation API. You must click ¡®Enable Automation¡¯ in order for

StatTag to work.

8. Click ¡®OK¡¯ to return to the main screen.

Note: You must install the StatTag plug-in first, before enabling the Stata Automation API. Both

installation of the StatTag plug-in and enabling the Stata Automation API require administrator

access on your computer. The Stata Automation Application Program Interface (API) allows

StatTag and Stata to exchange information. StatTag sends ¡®calls¡¯ to Stata to execute statistical

code, and Stata in turn sends back the results of the code to be inserted in the Word document.

You only have to do this step on initial installation of StatTag. Updates to StatTag will not require

re-enabling Stata Automation.

Steps 9-11 are for Python users ONLY

5|Page

 ................
................

In order to avoid copyright disputes, this page is only a partial summary.

Google Online Preview   Download