diff --git a/dev/changelog/index.html b/dev/changelog/index.html index ecd58c2..e9f4ca8 100644 --- a/dev/changelog/index.html +++ b/dev/changelog/index.html @@ -1 +1 @@ - Changelog - CRISPIN
Skip to content

Changelog

CRISPIN development version

CRISPIN 1.0.0

  • The pipeline name has been changed from CRUISE 🛳️ to CRISPIN 🍪. (#43, @kelly-sovacool)
  • Run spooker on workflow completion.
  • Print the recommended citation in bibtex format with crispin --citation. (#32, @kelly-sovacool)
  • Fix citation information (#38, @kelly-sovacool)
  • Improve the documentation website with a dropdown menu to select which version to view. The latest release is shown by default. (#45, @kelly-sovacool)

CRUISE 0.1.1

Bug fixes

  • All scripts in the bin directory are now made executable for all users on biowulf (#25).
  • Data directories are copied recursively during python package installation (#26).

CRUISE 0.1.0

This is the first release of CRUISE 🎉

New features

  • Trim adapters with cutadapt.
  • Run mageck count. (#9)
  • mageck count only runs if a count table isn't given.
  • Optional: run mageck test and mle. (#9)
  • mageck mle only runs if a design matrix is given.
  • Optional: run drugZ. (#10)
  • Optional: run BAGEL2. (#11)
  • fc (fold change)
  • bf (bayes factor)
  • pr (precision recall)
  • CLI (#16)
  • cruise init to initialize a project directory.
  • cruise run
    • --mode slurm to submit a slurm job to biowulf or frce.
    • --main path/to/main.nf to select a different local install of cruise, or specify the repo (CCBR/CRUISE) to get it from GitHub.

Last update: 2023-08-31
\ No newline at end of file + Changelog - CRISPIN
Skip to content

Changelog

CRISPIN development version

CRISPIN 1.0.1

CRISPIN 1.0.0

  • The pipeline name has been changed from CRUISE 🛳️ to CRISPIN 🍪. (#43, @kelly-sovacool)
  • Run spooker on workflow completion.
  • Print the recommended citation in bibtex format with crispin --citation. (#32, @kelly-sovacool)
  • Fix citation information (#38, @kelly-sovacool)
  • Improve the documentation website with a dropdown menu to select which version to view. The latest release is shown by default. (#45, @kelly-sovacool)

CRUISE 0.1.1

Bug fixes

  • All scripts in the bin directory are now made executable for all users on biowulf (#25).
  • Data directories are copied recursively during python package installation (#26).

CRUISE 0.1.0

This is the first release of CRUISE 🎉

New features

  • Trim adapters with cutadapt.
  • Run mageck count. (#9)
  • mageck count only runs if a count table isn't given.
  • Optional: run mageck test and mle. (#9)
  • mageck mle only runs if a design matrix is given.
  • Optional: run drugZ. (#10)
  • Optional: run BAGEL2. (#11)
  • fc (fold change)
  • bf (bayes factor)
  • pr (precision recall)
  • CLI (#16)
  • cruise init to initialize a project directory.
  • cruise run
    • --mode slurm to submit a slurm job to biowulf or frce.
    • --main path/to/main.nf to select a different local install of cruise, or specify the repo (CCBR/CRUISE) to get it from GitHub.

Last update: 2023-08-31
\ No newline at end of file diff --git a/dev/search/search_index.json b/dev/search/search_index.json index c93dd70..a74074c 100644 --- a/dev/search/search_index.json +++ b/dev/search/search_index.json @@ -1 +1 @@ -{"config":{"lang":["en"],"separator":"[\\s\\-]+","pipeline":["stopWordFilter"]},"docs":[{"location":"","title":"Home","text":""},{"location":"#crispin","title":"CRISPIN \ud83c\udf6a","text":"

CRISPr screen sequencing analysis pipelINe

formerly known as CRUISE

\ud83d\udea7 This project is under active development. It is not yet ready for production use. \ud83d\udea7

"},{"location":"#set-up","title":"Set up","text":"

CRISPIN is installed on the Biowulf HPC. For installation in other execution environments, refer to the docs.

"},{"location":"#biowulf","title":"Biowulf","text":"

CRISPIN is available on Biowulf in the ccbrpipeliner module. You'll first need to start an interactive session and create a directory from where you'll run crispin.

# start an interactive node\nsinteractive --mem=2g --cpus-per-task=2 --gres=lscratch:200\n# make a working directory for your project and go to it\nmkdir -p /data/$USER/crisprseq\ncd /data/$USER/crisprseq\n# load the ccbrpipeliener module\nmodule load ccbrpipeliner\n
"},{"location":"#usage","title":"Usage","text":"

Initialize and run crispin with test data:

# copy the crispin config files to your current directory\ncrispin init\n# preview the crispin jobs that will run with the test dataset\ncrispin run --mode local -profile test -preview\n# launch a crispin run on slurm with the test dataset\ncrispin run --mode slurm -profile test,biowulf\n

To run CRISPIN on your own data, you'll need to create a sample sheet. Take a look at the example: assets/samplesheet_test_biowulf.csv.

You'll also need to select an appropriate library for your dataset. CRISPIN is bundled with several libraries in assets/lib, or you can download your own. Once you've created a samplesheet with paths to your fastq files, run crispin with the --input option to specify the path to your sample sheet and --library for the path to your library file:

crispin run --mode slurm -profile biowulf --input samplesheet.csv --library assets/lib/yusa_library.csv\n
"},{"location":"#help-contributing","title":"Help & Contributing","text":"

Come across a bug? Open an issue and include a minimal reproducible example.

Have a question? Ask it in discussions.

Want to contribute to this project? Check out the contributing guidelines.

"},{"location":"#references","title":"References","text":"

This repo was originally generated from the CCBR Nextflow Template. The template takes inspiration from nektool1 and the nf-core template. If you plan to contribute your pipeline to nf-core, don't use this template -- instead follow nf-core's instructions2.

  1. nektool https://github.com/beardymcjohnface/nektool \u21a9

  2. instructions for nf-core pipelines https://nf-co.re/docs/contributing/tutorials/creating_with_nf_core \u21a9

"},{"location":"changelog/","title":"Changelog","text":""},{"location":"changelog/#crispin-development-version","title":"CRISPIN development version","text":""},{"location":"changelog/#crispin-100","title":"CRISPIN 1.0.0","text":""},{"location":"changelog/#cruise-011","title":"CRUISE 0.1.1","text":""},{"location":"changelog/#bug-fixes","title":"Bug fixes","text":""},{"location":"changelog/#cruise-010","title":"CRUISE 0.1.0","text":"

This is the first release of CRUISE \ud83c\udf89

"},{"location":"changelog/#new-features","title":"New features","text":""},{"location":"contributing/","title":"Contributing to CRISPIN","text":"

TODO -- describe gitflow, require PRs...

"},{"location":"contributing/#use-pre-commit-hooks","title":"Use pre-commit hooks","text":"

Pre-commit can automatically format your code, check for spelling errors, etc. every time you commit.

Install pre-commit if you haven't already, then run pre-commit install to install the hooks specified in .pre-commit-config.yaml. Pre-commit will run the hooks every time you commit.

"},{"location":"contributing/#versions","title":"Versions","text":"

Increment the version number following semantic versioning1 in the VERSION file.

"},{"location":"contributing/#changelog","title":"Changelog","text":"

Keep the changelog up to date with all notable changes in CHANGELOG.md2.

"},{"location":"contributing/#vs-code-extensions","title":"VS code extensions","text":"

If you use VS code, installing nf-core extension pack is recommended.

"},{"location":"contributing/#installation","title":"Installation","text":"

For testing and debugging, We recommend installing the dev version of crispin to a user-specific location.

git clone https://github.com/CCBR/CRISPIN\nmkdir -p ~/bin/crispin\npip install ./CRISPIN -t ~/bin/crispin\nexport PATH=\"$HOME/bin/crispin/bin:$PATH\"\n
  1. semantic versioning guidelines https://semver.org/ \u21a9

  2. changelog guidelines: https://keepachangelog.com/en/1.1.0/ \u21a9

"},{"location":"nextflow/","title":"nextflow pipeline","text":"

You can run the nextflow pipeline directly by specifying this GitHub repo. You will need nextflow and either singularity or docker installed. In this case you don't need to run crispin init first, as the config files will be accessed directly from the GitHub repo.

nextflow run CCBR/CRISPIN -profile test,singularity\n

You can specify a specific version, tag, or branch with -r:

nextflow run CCBR/CRISPIN -r v1.0.0 -profile test,singularity\n

Create and use a custom reference genome:

nextflow run CCBR/CRISPIN -profile test -entry MAKE_REFERENCE\nnextflow run CCBR/CRISPIN -profile test -c results/test/genome/custom_genome.config\n
"}]} \ No newline at end of file +{"config":{"lang":["en"],"separator":"[\\s\\-]+","pipeline":["stopWordFilter"]},"docs":[{"location":"","title":"Home","text":""},{"location":"#crispin","title":"CRISPIN \ud83c\udf6a","text":"

CRISPr screen sequencing analysis pipelINe

formerly known as CRUISE

\ud83d\udea7 This project is under active development. It is not yet ready for production use. \ud83d\udea7

"},{"location":"#set-up","title":"Set up","text":"

CRISPIN is installed on the Biowulf HPC. For installation in other execution environments, refer to the docs.

"},{"location":"#biowulf","title":"Biowulf","text":"

CRISPIN is available on Biowulf in the ccbrpipeliner module. You'll first need to start an interactive session and create a directory from where you'll run crispin.

# start an interactive node\nsinteractive --mem=2g --cpus-per-task=2 --gres=lscratch:200\n# make a working directory for your project and go to it\nmkdir -p /data/$USER/crisprseq\ncd /data/$USER/crisprseq\n# load the ccbrpipeliener module\nmodule load ccbrpipeliner\n
"},{"location":"#usage","title":"Usage","text":"

Initialize and run crispin with test data:

# copy the crispin config files to your current directory\ncrispin init\n# preview the crispin jobs that will run with the test dataset\ncrispin run --mode local -profile test -preview\n# launch a crispin run on slurm with the test dataset\ncrispin run --mode slurm -profile test,biowulf\n

To run CRISPIN on your own data, you'll need to create a sample sheet. Take a look at the example: assets/samplesheet_test_biowulf.csv.

You'll also need to select an appropriate library for your dataset. CRISPIN is bundled with several libraries in assets/lib, or you can download your own. Once you've created a samplesheet with paths to your fastq files, run crispin with the --input option to specify the path to your sample sheet and --library for the path to your library file:

crispin run --mode slurm -profile biowulf --input samplesheet.csv --library assets/lib/yusa_library.csv\n
"},{"location":"#help-contributing","title":"Help & Contributing","text":"

Come across a bug? Open an issue and include a minimal reproducible example.

Have a question? Ask it in discussions.

Want to contribute to this project? Check out the contributing guidelines.

"},{"location":"#references","title":"References","text":"

This repo was originally generated from the CCBR Nextflow Template. The template takes inspiration from nektool1 and the nf-core template. If you plan to contribute your pipeline to nf-core, don't use this template -- instead follow nf-core's instructions2.

  1. nektool https://github.com/beardymcjohnface/nektool \u21a9

  2. instructions for nf-core pipelines https://nf-co.re/docs/contributing/tutorials/creating_with_nf_core \u21a9

"},{"location":"changelog/","title":"Changelog","text":""},{"location":"changelog/#crispin-development-version","title":"CRISPIN development version","text":""},{"location":"changelog/#crispin-101","title":"CRISPIN 1.0.1","text":""},{"location":"changelog/#crispin-100","title":"CRISPIN 1.0.0","text":""},{"location":"changelog/#cruise-011","title":"CRUISE 0.1.1","text":""},{"location":"changelog/#bug-fixes","title":"Bug fixes","text":""},{"location":"changelog/#cruise-010","title":"CRUISE 0.1.0","text":"

This is the first release of CRUISE \ud83c\udf89

"},{"location":"changelog/#new-features","title":"New features","text":""},{"location":"contributing/","title":"Contributing to CRISPIN","text":"

TODO -- describe gitflow, require PRs...

"},{"location":"contributing/#use-pre-commit-hooks","title":"Use pre-commit hooks","text":"

Pre-commit can automatically format your code, check for spelling errors, etc. every time you commit.

Install pre-commit if you haven't already, then run pre-commit install to install the hooks specified in .pre-commit-config.yaml. Pre-commit will run the hooks every time you commit.

"},{"location":"contributing/#versions","title":"Versions","text":"

Increment the version number following semantic versioning1 in the VERSION file.

"},{"location":"contributing/#changelog","title":"Changelog","text":"

Keep the changelog up to date with all notable changes in CHANGELOG.md2.

"},{"location":"contributing/#vs-code-extensions","title":"VS code extensions","text":"

If you use VS code, installing nf-core extension pack is recommended.

"},{"location":"contributing/#installation","title":"Installation","text":"

For testing and debugging, We recommend installing the dev version of crispin to a user-specific location.

git clone https://github.com/CCBR/CRISPIN\nmkdir -p ~/bin/crispin\npip install ./CRISPIN -t ~/bin/crispin\nexport PATH=\"$HOME/bin/crispin/bin:$PATH\"\n
  1. semantic versioning guidelines https://semver.org/ \u21a9

  2. changelog guidelines: https://keepachangelog.com/en/1.1.0/ \u21a9

"},{"location":"nextflow/","title":"nextflow pipeline","text":"

You can run the nextflow pipeline directly by specifying this GitHub repo. You will need nextflow and either singularity or docker installed. In this case you don't need to run crispin init first, as the config files will be accessed directly from the GitHub repo.

nextflow run CCBR/CRISPIN -profile test,singularity\n

You can specify a specific version, tag, or branch with -r:

nextflow run CCBR/CRISPIN -r v1.0.0 -profile test,singularity\n

Create and use a custom reference genome:

nextflow run CCBR/CRISPIN -profile test -entry MAKE_REFERENCE\nnextflow run CCBR/CRISPIN -profile test -c results/test/genome/custom_genome.config\n
"}]} \ No newline at end of file