Skip to content

Commit ca4f4c8

Browse files
author
Fernando Gelin
authored
Merge pull request #32 from compbiocore/develop
Rename VIVA to VariantVisualization and make small docs changes
2 parents 0ed0326 + e1a9985 commit ca4f4c8

22 files changed

+810
-574294
lines changed

LICENSE.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
1-
The ViVa.jl package is licensed under the MIT "Expat" License:
1+
The VariantVisualization.jl package is licensed under the MIT "Expat" License:
22

33
> Copyright (c) 2018: Computational Biology Core - Data Science Practice - Brown University.
44
>

Project.toml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
1-
name = "VIVA"
1+
name = "VariantVisualization"
22
uuid = "d7f9f8fa-e687-11e8-2c0b-eb4ab256ef6a"
33
authors = ["George Tollefson <gatollefson@gmail.com>"]
44
version = "0.3.1"

README.md

Lines changed: 19 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -1,17 +1,22 @@
1-
# ViVa.jl
1+
# VariantVisualization.jl
22

33
#### Visualization of Variants
44

55

66
| MacOS / Linux | License | Test Coverage | Documentation | Lifecycle |
77
| --- | ---- | ------ | ------ | ---- |
8-
|[![Travis](https://img.shields.io/travis/compbiocore/VIVA.jl/master.svg?style=flat-square)](https://travis-ci.org/compbiocore/VIVA.jl)| [![License](https://img.shields.io/badge/license-MIT-orange.svg?style=flat-square)](https://github.com/compbiocore/VIVA.jl/blob/clean-up/LICENSE.md)| [![Codecov](https://img.shields.io/codecov/c/github/compbiocore/VIVA.jl.svg?style=flat-square)](https://codecov.io/gh/compbiocore/VIVA.jl/branch/master) | [![Docs](https://img.shields.io/badge/docs-stable-blue.svg?style=flat-square)](https://compbiocore.github.io/VIVA.jl/stable) [![Docs](https://img.shields.io/badge/docs-latest-blue.svg?style=flat-square)](https://compbiocore.github.io/VIVA.jl/latest) | ![Lifecycle](https://img.shields.io/badge/lifecycle-experimental-orange.svg?style=flat-square) |
8+
|[![Travis](https://img.shields.io/travis/compbiocore/VariantVisualization.jl/master.svg?style=flat-square)](https://travis-ci.org/compbiocore/VariantVisualization.jl)| [![License](https://img.shields.io/badge/license-MIT-orange.svg?style=flat-square)](https://github.com/compbiocore/VariantVisualization.jl/blob/clean-up/LICENSE.md)| [![Codecov](https://img.shields.io/codecov/c/github/compbiocore/VariantVisualization.jl.svg?style=flat-square)](https://codecov.io/gh/compbiocore/VariantVisualization.jl/branch/master) | [![Docs](https://img.shields.io/badge/docs-stable-blue.svg?style=flat-square)](https://compbiocore.github.io/VariantVisualization.jl/stable) [![Docs](https://img.shields.io/badge/docs-latest-blue.svg?style=flat-square)](https://compbiocore.github.io/VariantVisualization.jl/latest) | ![Lifecycle](https://img.shields.io/badge/lifecycle-experimental-orange.svg?style=flat-square) |
99

1010
## Overview
1111

12-
VIVA.jl is a user-friendly command line tool for creating publication quality graphics from Variant Call Format (VCF) files and has been designed for clinicians and bioinformaticians to explore their VCF files visually. Users can quickly extract genotype or read depth information and plot trends in interactive categorical heatmaps and scatter plots of average read depth values. ViVa.jl offers a robust set of filters to select variants and samples of interest for analysis. ViVa.jl is especially useful in early data exploration for identifying batch effect and sources of poor read depth, as well as identifying distribution of disease causing variants in a set of clinical samples.
12+
VariantVisualization.jl is a package we built specifically to power the genetics visualization tool, *VIVA*.
1313

14-
## Installation
14+
*VIVA* is a user-friendly command line tool for creating publication quality graphics from Variant Call Format (VCF) files and has been designed for clinicians and bioinformaticians to explore their VCF files visually. Users can quickly extract genotype or read depth information and plot trends in interactive categorical heatmaps and scatter plots of average read depth values. VIVA offers a robust set of filters to select variants and samples of interest for analysis. VIVA is especially useful in early data exploration for identifying batch effect and sources of poor read depth, as well as identifying distribution of disease causing variants in a set of clinical samples.
15+
16+
To contribute to *VIVA*, developers may use the functions contained
17+
18+
19+
## Getting Started: *Installation*
1520

1621
### Supported Operating Systems:
1722

@@ -23,32 +28,36 @@ Windows 10, Windows 7
2328

2429
### Command Line Tool
2530

26-
Add VIVA.jl in the Julia Pkg prompt.
31+
1. Add VariantVisualization.jl in the Julia Pkg prompt.
32+
2. Download the [VIVA](https://github.com/compbiocore/VariantVisualization.jl/tree/master/VIVA) tool script and save it to a working directory for your analysis.
33+
3. Navigate to your working directory and follow the [VIVA manual](https://compbiocore.github.io/VIVA.jl/latest) to generate your plots.
2734

2835
### Jupyer Notebook
2936

30-
Install Jupyter and download the [VIVA Jupyter Notebook]().
37+
1. [Install Jupyter](https://jupyter.org/install)
38+
2. Download the [VIVA Jupyter Notebook](https://github.com/compbiocore/VariantVisualization.jl/tree/master/VIVA.ipynb).
39+
3. Follow the in-notebook instructions to generate your plots.
3140

3241
### Latest Features
3342

34-
To stay up to date with cutting edge development features install VIVA.jl from the Master branch.
43+
To stay up to date with cutting edge development features install VariantVisualization.jl from the Master branch.
3544

3645
Using git from the command line:
3746

3847
```
39-
git clone https://github.com/compbiocore/ViVa.jl
48+
git clone https://github.com/compbiocore/VariantVisualization.jl
4049
```
4150

4251
or from the Julia REPL (useful if using the PowerShell and don't have git installed):
4352

4453
```julia
4554
using Pkg
46-
Pkg.clone("https://github.com/compbiocore/ViVa.jl")
55+
Pkg.clone("https://github.com/compbiocore/VariantVisualization.jl")
4756
```
4857

4958
## Contributing and Questions
5059

5160
Contributions are welcome, as are feature requests and suggestions. Please open an
5261
[issue][issues-url] if you encounter any problems or would just like to ask a question.
5362

54-
[issues-url]: https://github.com/compbiocore/VIVA.jl/issues
63+
[issues-url]: https://github.com/compbiocore/VariantVisualization.jl/issues

0 commit comments

Comments
 (0)