Skip to content

Commit

Permalink
Merge pull request #98 from tanubrata/master
Browse files Browse the repository at this point in the history
Update: Updates README.md with latest Docker image
  • Loading branch information
shihabdider authored Nov 17, 2023
2 parents f0cf34e + 8ba9dd9 commit b4d4b01
Show file tree
Hide file tree
Showing 2 changed files with 24 additions and 6 deletions.
4 changes: 2 additions & 2 deletions DESCRIPTION
Original file line number Diff line number Diff line change
Expand Up @@ -11,14 +11,14 @@ biocViews:
bioc::3.15/GenomicRanges,
bioc::3.15/rtracklayer,
bioc::3.15/VariantAnnotation,
bioc::3.15/copynumber,
Remotes:
github::mskilab-org/bamUtils,
github::mskilab-org/gUtils,
github::mskilab-org/gTrack,
github::mskilab-org/gChain,
github::mskilab-org/gGnome,
url::https://cran.r-project.org/src/contrib/Archive/sequenza/sequenza_3.0.0.tar.gz
url::https://cran.r-project.org/src/contrib/Archive/sequenza/sequenza_3.0.0.tar.gz,
url::https://bioconductor.statistik.tu-dortmund.de/packages/3.15/bioc/src/contrib/copynumber_1.36.0.tar.gz,
Depends:
R (>= 4.0.0),
GenomicRanges,
Expand Down
26 changes: 22 additions & 4 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -33,7 +33,25 @@ If you use JaBbA in your work, please cite: [Distinct Classes of Complex Structu

### Dockerized installation

A Docker container with the latest stable release of JaBbA and its dependencies installed can be found [here](https://hub.docker.com/r/graskind1/jabba) - many thanks to [grasskind](https://github.com/grasskind).
A Docker container with the latest stable release of JaBbA v1.1 and its dependencies installed can be found [here](https://hub.docker.com/r/mskilab/jabba).

#### :warning: **Warning:**

JaBbA depends on CPLEX MIP Optimizer to work. Because CPLEX is a proprietary software, it isn't included in the image and needs to be installed by the user.
To add CPLEX:
> 1. Download CPLEX (Linux x86-64). (You may need to use the HTTP method.)
> 2. Pull image and run the container using:
> ```
> docker pull mskilab/jabba:latest
> docker run -it --rm --platform linux/amd64 mskilab/jabba:latest
> ```
> 3. Copy CPLEX binary into the container: docker cp /PATH/TO/DOWNLOADED_CPLEX.bin CONTAINER_ID:/opt/cplex_studio
> 4. Install CPLEX: /opt/cplex_studio/DOWNLOADED_CPLEX.bin (If you get a Permission denied error, run
> chmod 777 /PATH/TO/DOWNLOADED_CPLEX.bin before copying it into the container.)
> 5. When prompted for an installation path, type /opt/cplex. This is what the CPLEX_DIR environmental variable is set to.
> 6. Save changes to a new image for future use:
> Exit container (type exit or press Ctrl-D)
> Run docker commit CONTAINER_ID NEW_IMAGE_ID
### Installation from GitHub
Expand All @@ -54,7 +72,7 @@ export CPLEX_DIR=/path/to/your/copy/of/CPLEX_Studio/
3. Install JaBbA

```{r}
devtools::install_github('mskilab/JaBbA')
devtools::install_github('mskilab-org/JaBbA')
```

4. For convenience, add `jba` executable to your `PATH`
Expand All @@ -70,7 +88,7 @@ $ jba ## to see usage
$ jba ${JABBA_PATH}/junctions.vcf ${JABBA_PATH}/coverage.txt
```

**_WARNING_** :
:warning: **_WARNING_** :
`JaBbA` uses some functions from `gGnome` package as a wrapper that needs`CPLEX` functionality to be added to `gGnome`. If the dependency package `gGnome` was installed before installing `JaBbA` or if CPLEX functionality was not added while installing `gGnome` or if you get an error while running JaBbA as shown below:
```{bash}
Error in names(x) <- c("xopt", "obj", "status", "extra", "epgap") :
Expand All @@ -92,7 +110,7 @@ As of ```v1.1``` JaBbA can now be run with [Gurobi](https://www.gurobi.com/produ

4. Install JaBbA
```{r}
devtools::install_github('mskilab/JaBbA')
devtools::install_github('mskilab-org/JaBbA')
```

5. For convenience, add `jba` executable to your `PATH`
Expand Down

0 comments on commit b4d4b01

Please sign in to comment.