Merge pull request #66 from compbiocore/develop

fernandogelin · web-flow · commit 5330ef3f3e41 · 2019-07-25T09:04:55.000-04:00
Include instructions on how to add Julia bins to windows path variable
diff --git a/Project.toml b/Project.toml
@@ -1,7 +1,7 @@
 name = "VariantVisualization"
 uuid = "7f8bf45c-0ad5-53b5-97e6-33c1305e0aa4"
 authors = ["George Tollefson <gatollefson@gmail.com>"]
-version = "0.4.0"
+version = "0.4.1"
 
 [deps]
 ArgParse = "c7e460c6-2fb9-53a9-8c5b-16f535851c63"
diff --git a/README.md b/README.md
@@ -30,7 +30,7 @@ To use VIVA, you must download the Julia programming language version >=1.0 and
 
 Expected Time for Installation: Installation time depends on your network bandwidth, but should take less than 10 minutes for VIVA installation to install all dependency packages. Installing and using Julia packages for the first time takes longer than when using them in subsequent sessions.
 
-*Note*: When installing VariantVisualization.jl and running VIVA remote compute clusters, you may need to load the OpenGl module in addition to loading the Julia module.
+*Note*: When installing Julia and running VIVA on Windows, you will need to add Julia to the Windows path variable. This takes ~ 1 minute following the instructions found [here](https://compbiocore.github.io/VariantVisualization.jl/latest/installation/)
 
 ### Command Line Tool
 
@@ -52,98 +52,6 @@ Expected Time for Installation: Installation time depends on your network bandwi
 4. Open the VIVA Jupyter Notebook following the instructions in the [manual](https://compbiocore.github.io/VariantVisualization.jl/latest/).
 4. Follow the in-notebook instructions to generate your plots.
 
-### Running VIVA with Docker or Docker Compose
-
-Alternatively, you can run VIVA using the Docker images we've provided if you don't want to install Julia and the VariantVisualization.jl Julia package. You may only save images to HTML format using the Docker, for now, due to technical limitations of dependency packages. We've actively developing a feature to save to all formats using Docker.
-
-To run VIVA from a Docker image, first [install Docker](https://docs.docker.com/install/).
-
-Then double-click the Docker.app in the Applications folder to start Docker. You will see a whale icon in the top status bar to indicate that Docker is running and accessible from the terminal. You can quit Docker once you are finished using VIVA by clicking the Docker whale icon in the top status bar and clicking "Quit Docker Desktop."
-
-#### Using Docker
-
-*Note*: You must use the flag `--save_remotely` when running VIVA by using Docker.
-
-Once Docker is running, you can run VIVA by running the Docker commands below in the Mac/Linux terminal or Windows PowerShell.
-
-We provide two images, one with a Jupyter Notebook and one with a command line script for VIVA. You can run VIVA in a single command using these images. The command consists of calls to run the Docker image followed by the usual VIVA options.
-
-To run the images, follow these steps:
-
-Create a project folder and navigate to it:
-```shell
-mkdir project_x
-cd project_x
-```
-
-Make sure to add your project VCF files to that folder. That directory will be mapped to `/notebook/data` inside of the container.
-
-When entering the filename of the VCF file and files to support filtering options, you should include `/data/...` in the path to your files.
-
-##### Run the VIVA Command Line Tool from a Docker image:
-
-*Note*: Remember, you must use the flag `--save_remotely` when running VIVA by using Docker.
-
-- On Mac or Linux:
-```shell
-docker run -it --rm -v "$PWD":/data compbiocore/viva-cli --save_remotely arg1 arg2 arg3
-```
-
-- Example run:
-```shell
-docker run -it --rm -v "$PWD":/data compbiocore/viva-cli --save_remotely -f file.vcf -p
-```
-
-- On Windows:
-```shell
-docker run -it --rm -v "${pwd}":/data compbiocore/viva-cli --save_remotely arg1 arg2 arg3
-```
-
-- Example run:
-```shell
-docker run -it --rm -v "${pwd}":/data compbiocore/viva-cli --save_remotely -f file.vcf -p
-```
-
-##### Run the VIVA Jupyter Notebook from a Docker image:
-
-Copy and run the following line from the terminal or Windows PowerShell:
-
-- On Mac or Linux:
-```shell
-docker run --rm -p 8888:8888 -e JUPYTER_ENABLE_LAB=yes -v "$PWD":/home/jovyan/notebook/data compbiocore/viva-notebook
-```
-
-Go to the following url in your internet browser. You'll receive a token to enter into the url.
-
-Go to `http://0.0.0.0:8888/?token=<enter token here>`
-
-- On Windows:
-```shell
-docker run --rm -p 8888:8888 -e JUPYTER_ENABLE_LAB=yes -v "${pwd}":/home/jovyan/notebook/data compbiocore/viva-notebook
-```
-
-Go to the following url in your internet browser. You'll receive a token to enter into the url.
-
-Go to `http://0.0.0.0:8888/?token=<enter token here>`
-
-[Click here](https://jupyter-docker-stacks.readthedocs.io/en/latest/index.html) for more information about Jupyter Docker Images.
-
-#### Using Docker Compose
-
-To run the images with Docker Compose, copy the [`docker-compose.yml`](https://github.com/compbiocore/viva-docker/blob/master/docker-compose.yml) file to a local directory. From that same directory, run the command as it appears below.
-
-*Note*: Your current directory will mount to `/notebook/data` in the notebook image and to `/data` in the CLI image.
-
-- Notebook
-```shell
-docker-compose up viva-notebook
-```
-
-- Command Line Tool
-```shell
-docker-compose run viva -f file.vcf --save_remotely arg3 arg4 ...
-```
-
 ### Latest Features
 
 To stay up to date with cutting edge development features install VariantVisualization.jl from the Master branch.
diff --git a/docs/src/index.md b/docs/src/index.md
@@ -80,98 +80,6 @@ Use the following steps to use the VIVA Jupyter Notebook utility:
 
 6. Follow the step-by-step instructions within the notebook to generate your figures.
 
-### Running VIVA with Docker or Docker Compose
-
-Alternatively, you can run VIVA using the Docker images we've provided if you don't want to install Julia and the VariantVisualization.jl Julia package. You may only save images to HTML format using the Docker, for now, due to technical limitations of dependency packages. We've actively developing a feature to save to all formats using Docker.
-
-To run VIVA from a Docker image, first [install Docker](https://docs.docker.com/install/).
-
-Then double-click the Docker.app in the Applications folder to start Docker. You will see a whale icon in the top status bar to indicate that Docker is running and accessible from the terminal. You can quit Docker once you are finished using VIVA by clicking the Docker whale icon in the top status bar and clicking "Quit Docker Desktop."
-
-#### Using Docker
-
-*Note*: You must use the flag `--save_remotely` when running VIVA by using Docker.
-
-Once Docker is running, you can run VIVA by running the Docker commands below in the Mac/Linux terminal or Windows PowerShell.
-
-We provide two images, one with a Jupyter Notebook and one with a command line script for VIVA. You can run VIVA in a single command using these images. The command consists of calls to run the Docker image followed by the usual VIVA options.
-
-To run the images, follow these steps:
-
-Create a project folder and navigate to it:
-```shell
-mkdir project_x
-cd project_x
-```
-
-Make sure to add your project VCF files to that folder. That directory will be mapped to `/notebook/data` inside of the container.
-
-When entering the filename of the VCF file and files to support filtering options, you should include `/data/...` in the path to your files.
-
-##### Run the VIVA Command Line Tool from a Docker image:
-
-*Note*: Remember, you must use the flag `--save_remotely` when running VIVA by using Docker.
-
-- On Mac or Linux:
-```shell
-docker run -it --rm -v "$PWD":/data compbiocore/viva-cli:v0.3.8 --save_remotely arg1 arg2 arg3
-```
-
-- Example run:
-```shell
-docker run -it --rm -v "$PWD":/data compbiocore/viva-cli:v0.3.8 --save_remotely -f file.vcf -p
-```
-
-- On Windows:
-```shell
-docker run -it --rm -v "${pwd}":/data compbiocore/viva-cli:v0.3.8 --save_remotely arg1 arg2 arg3
-```
-
-- Example run:
-```shell
-docker run -it --rm -v "${pwd}":/data compbiocore/viva-cli:v0.3.8 --save_remotely -f file.vcf -p
-```
-
-##### Run the VIVA Jupyter Notebook from a Docker image:
-
-Copy and run the following line from the terminal or Windows PowerShell:
-
-- On Mac or Linux:
-```shell
-docker run --rm -p 8888:8888 -e JUPYTER_ENABLE_LAB=yes -v "$PWD":/home/jovyan/notebook/data compbiocore/viva-notebook
-```
-
-Go to the following url in your internet browser. You'll receive a token to enter into the url.
-
-Go to `http://0.0.0.0:8888/?token=<enter token here>`
-
-- On Windows:
-```shell
-docker run --rm -p 8888:8888 -e JUPYTER_ENABLE_LAB=yes -v "${pwd}":/home/jovyan/notebook/data compbiocore/viva-notebook
-```
-
-Go to the following url in your internet browser. You'll receive a token to enter into the url.
-
-Go to `http://0.0.0.0:8888/?token=<enter token here>`
-
-[Click here](https://jupyter-docker-stacks.readthedocs.io/en/latest/index.html) for more information about Jupyter Docker Images.
-
-#### Using Docker Compose
-
-To run the images with Docker Compose, install Docker following the steps above and then install [Docker Compose[(https://docs.docker.com/compose/). Then copy the [docker-compose.yml](https://github.com/compbiocore/viva-docker/blob/master/docker-compose.yml) file to a local directory. From that same directory, run the command as it appears below.
-
-*Note*: Your current directory will mount to `/notebook/data` in the notebook image and to `/data` in the CLI image.
-
-- Notebook
-```shell
-docker-compose up viva-notebook
-```
-
-- Command Line Tool
-```shell
-docker-compose run viva -f file.vcf --save_remotely arg3 arg4 ...
-```
-
 ## Continue reading for:
 
 * [Variant and Sample Selection](https://compbiocore.github.io/VariantVisualization.jl/stable/filtering_vcf/)
diff --git a/docs/src/installation.md b/docs/src/installation.md
@@ -15,6 +15,12 @@ Windows 10, Windows 7.
 
 To install Julia on Windows, you can follow the [platform specific instructions](https://julialang.org/downloads/platform.html).
 
+To run VIVA using Julia from the command prompt or PowerShell, *you will need to add Julia to the Windows path variable*. This should be a quick step (est. time to complete: 1 minute)
+
+To add Julia to the PATH on Windows 7 or Windows 10:
+
+Add the path to the Julia binaries (C:\Program Files\Julia\bin) to the PATH following the concise instructions [found here](https://www.java.com/en/download/help/path.xml)
+
 #### Linux
 
 *Note*: To run on remote compute clusters, you may need to load opengl module along with julia/1.1.0.
@@ -35,7 +41,9 @@ To install Julia on Windows, you can follow the [platform specific instructions]
 3. Download the [VIVA Jupyter Notebook](https://github.com/compbiocore/VariantVisualization.jl/blob/master/VIVA.ipynb).
 4. Follow the in-notebook instructions to generate your plots.
 
-### Running VIVA with Docker or Docker Compose
+### Running VIVA with Docker or Docker Compose (Under Active Development)
+
+Soon, you will be able to run VIVA using Docker images. This is not yet a supported feature. The instructions below will be helpful once this is supported.
 
 Alternatively, you can run VIVA using the Docker images we've provided if you don't want to install Julia and the VariantVisualization.jl Julia package. You may only save images to HTML format using the Docker, for now, due to technical limitations of dependency packages. We've actively developing a feature to save to all formats using Docker.
 
diff --git a/test/.DS_Store b/test/.DS_Store
