Skip to content

Commit fc38335

Browse files
authored
Merge pull request #589 from Sage-Bionetworks/update_local_validator_doc
Update local validator README
2 parents 145992c + 9ba1fb8 commit fc38335

File tree

1 file changed

+32
-1
lines changed

1 file changed

+32
-1
lines changed

README.md

Lines changed: 32 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -32,18 +32,49 @@ This package contains both R, Python and cli tools. These are tools or packages
3232

3333
One of the features of the `aacrgenie` package is that is provides a local validation tool that GENIE data contributors and install and use to validate their files locally prior to uploading to Synapse.
3434

35+
36+
### Setting up your environment
37+
38+
These instructions will install all the necessary components for you to run the validator locally on all of your files, including the Synapse client.
39+
40+
1. Create a virtual environment using package manager of your choice (e.g: `conda`, `pipenv`)
41+
42+
2. Install the genie package
43+
3544
```
3645
pip install aacrgenie
46+
```
47+
48+
3. Verify the installation
49+
50+
```
3751
genie -v
3852
```
3953

40-
This will install all the necessary components for you to run the validator locally on all of your files, including the Synapse client. Please view the help to see how to run to validator.
54+
4. Set up authentication with Synapse through the [local .synapseConfig](https://python-docs.synapse.org/tutorials/authentication/#use-synapseconfig) or using an [environment variable](https://python-docs.synapse.org/tutorials/authentication/#use-environment-variable)
55+
56+
### Running the validator
57+
58+
Get help of all available commands
4159

4260
```
4361
genie validate -h
62+
```
63+
64+
### Example commands
65+
66+
Running validator on clinical file
67+
68+
```
4469
genie validate data_clinical_supp_SAGE.txt SAGE
4570
```
4671

72+
Running validator on cna file. **Note** that the flag `--nosymbol-check` is **REQUIRED** when running the validator for cna files because you would need access to an internal bed database table without it. For DEVELOPERS this is not required.
73+
74+
```
75+
genie validate data_cna_SAGE.txt SAGE --nosymbol-check
76+
```
77+
4778

4879
## Contributing
4980

0 commit comments

Comments
 (0)