Utility commands for CorEvitas Biostats

The corrona suite of commands is a collection of internally-developed utilities to increase productivity in the Biostatistics department.

These commands should not be used by those not employed by or affiliated with CorEvitas LLC. Attempting to use them on non-CorEvitas resources without permission will result in an error or invalid results.

Available commands

Documentation

cordd: Create data dictionary

Data management

corcf: Compare values of variables between two datasets

corset: Set properties of variables for tabling

Tables

cortable: create formatted tables in Word

Getting and maintaining commands

Configuration

Before you can install any new corrona commands, you need to correctly configure your installation settings.

Verify your settings by typing

. net query

which should show you

from    "https://raw.githubusercontent.com/Corrona-IT/corcmds/master"
ado     c:\ado\plus\
other   (current directory)

If it does not, follow the appropriate steps below for configuring your installation. Otherwise, skip to the Getting commands section.

Configuring installation

If your ado path does not show as

c:\ado\plus(Windows)
~/ado/plus (Mac)

You need to change the installation location. You set the location for installing the corrona commands by typing

. net set ado PLUS

The Corrona commands are installed using the net command. To change the location the commands are downloaded from,

. net from "https://raw.githubusercontent.com/Corrona-IT/corcmds/master"

Getting commands

To install the commands, you can click the "corrona" link that appears when you type the net from command above and then click the install link in the help file. Alternately, you can install the full package of Corrona commands by typing

. net install corrona

Short descriptions of each corrona command are displayed above. To view a complete description, including the command's help file, you can click the link that appears when you type net describe.

Maintaining commands

The corrona commands are periodically updated with improvements and bug fixes. As with all user-written commands, the corrona suite is not updated automatically when you update Stata. You must make sure that you maintain the commands yourself. To do this, use the adoupdate command periodically.

. adoupdate

Getting help

All corrona commands come with help files. If you run into a specific problem, see the Troubleshooting section below. If you encounter a bug that is not already described, please report it by creating a new issue.

Troubleshooting

Unable to change installation directory

You do not need to use the net set command unless you see something other than the listed plus directory for your OS. If you try, you may get a message that Stata is not able to change the directory. There are two known causes of this error.

1. The appropriate plus directory does not yet exist on your computer. Solve this by creating the directory.
2. You do not have administrator privelages to the ado directory. Please contact IT to resolve this issue.

Files exist already

If you previously helped with the testing of these commands, you may have copies in your personal directory or you may have copies in plus that conflict with the versions installed from the official distribution location. Make sure you delete any copies in your personal directory and, if you get an error about conflicts, follow the prompts to force installation (or specify the force option if you use the net install command instead of clicking through the links).

Integrity check error

If you receive an integrity check error, the most likely cause is that you do not have permissions for the commands. There are three ways to resolve this:

1. Ensure you have a valid OneDrive account through Corrona that is syncing on your computer. This is the same location you use when sending links to attachments via Outlook instead of the attachment itself.
2. Sync to any of the registry data locations on SharePoint.
3. Open a new issue showing the results of listing Corrona directories as well as your user name. Attach the log that is created by the following to the issue that you create.

   log using myinfo.txt, text replace
   ls ~/*Corrona*
   display "`c(username)'"
   log close