+ "description": "<h1>\n <picture>\n <source media=\"(prefers-color-scheme: dark)\" srcset=\"docs/images/nf-core-lsmquant_logo_dark.png\">\n <img alt=\"nf-core/lsmquant\" src=\"docs/images/nf-core-lsmquant_logo_light.png\">\n </picture>\n</h1>\n\n[](https://github.com/codespaces/new/nf-core/lsmquant)\n[](https://github.com/nf-core/lsmquant/actions/workflows/nf-test.yml)\n[](https://github.com/nf-core/lsmquant/actions/workflows/linting.yml)[](https://nf-co.re/lsmquant/results)[](https://doi.org/10.5281/zenodo.XXXXXXX)\n[](https://www.nf-test.com)\n\n[](https://www.nextflow.io/)\n[](https://github.com/nf-core/tools/releases/tag/3.5.1)\n[](https://docs.conda.io/en/latest/)\n[](https://www.docker.com/)\n[](https://sylabs.io/docs/)\n[](https://cloud.seqera.io/launch?pipeline=https://github.com/nf-core/lsmquant)\n\n[](https://nfcore.slack.com/channels/lsmquant)[](https://bsky.app/profile/nf-co.re)[](https://mstdn.science/@nf_core)[](https://www.youtube.com/c/nf-core)\n\n\n## Introduction\n\n**nf-core/lsmquant** is a bioinformatics pipeline that performs preprocessing and analysis of light-sheet microscopy images of tissue cleared samples. The pipeline takes raw images from a directory or a zip archive as input. The images need to be in a 2D single-channel 16-bit `tif`format.\n\n<div style=\"text-align: center;\">\n<img src=\"docs/images/lsmquant-metromap.svg\" alt=\"lasmquant metromap\">\n</div>\n\n## Pipeline Summary\n\nThe pipeline consists of 3 major components: Preprocessing, Cell-Nuclei quantification, and Allen Reference Atlas registration. A detailed explanation on each method can be found in the [Methods description](./docs/usage.md) section.\n\n**Preprocessing**\n\nThis stage reconstructs the 3D image from raw light-sheet data. Here three different workflows can be chosen:\n\n1. `int_align_stitch`: Performs intensity adjustment, channel alignment, and iterative tile stitching\n\n2. `int_stitch`: Performs intensity adjustment and iterative tile stitching.\n\n3. `stitch_only`: Performs only iterative tile stitching\n\n**Allen Brain Atlas Registration (Optional)**\n\nThis workflow registers full brain images to the Allen Brain Reference Atlas. This is an optional workflow and can be chosen by setting the parameter: `ara_registartion`\n\n**Cell Nuclei Quantification**\n\nQuantification of cell-nuclei is performed using a 3D-Unet and it is performed on the nuclear channel only. This is an optional workflow and can be chosen by setting the parameter:`nuclei_quantification`\n\n## Usage\n\n> [!NOTE]\n> If you are new to Nextflow and nf-core, please refer to [this page](https://nf-co.re/docs/usage/installation) on how to set-up Nextflow. Make sure to [test your setup](https://nf-co.re/docs/usage/introduction#how-to-run-a-pipeline) with `-profile test` before running the workflow on actual data.\n\nTo run the pipeline you need to provide a samplesheet with your data in the following structure:\n\n`samplesheet.csv`\n\n```csv\nsample_id,img_directory,parameter_file\nTEST1,path/to/image-files,path/to/parameter/file.csv\n```\n\nThe parameter csv file includes sample specific parameters that are used for processing the given data. It needs to follow a specific structure.\n\nPlease get the basic template file [here](../assets/params_template_lsmquant.csv).\n`parametersheet.csv`\n\nNow, you can run the pipeline using:\n\n<!-- TODO nf-core: update the following command to include all required parameters for a minimal example -->\n\n```bash\nnextflow run nf-core/lsmquant \\\n -profile <docker/singularity/.../institute> \\\n --input <samplesheet.csv> \\\n --outdir <OUTDIR> \\\n --stage <stage>\n```\n\n> [!WARNING]\n> Please provide pipeline parameters via the CLI or Nextflow `-params-file` option. Custom config files including those provided by the `-c` Nextflow option can be used to provide any configuration _**except for parameters**_; see [docs](https://nf-co.re/docs/usage/getting_started/configuration#custom-configuration-files).\n\nFor more details and further functionality, please refer to the [usage documentation](https://nf-co.re/lsmquant/usage) and the [parameter documentation](https://nf-co.re/lsmquant/parameters).\n\n## Pipeline output\n\nTo see the results of an example test run with a full size dataset refer to the [results](https://nf-co.re/lsmquant/results) tab on the nf-core website pipeline page.\nFor more details about the output files and reports, please refer to the\n[output documentation](https://nf-co.re/lsmquant/output).\n\n## Credits\n\nnf-core/lsmquant was originally written by [Carolin Schwitalla](https://github.com/CaroAMN) at the Quantitative Biology Center and the University of Tuebingen ([QBiC](https://www.info.qbic.uni-tuebingen.de/)) in collaboration with the [Stein Lab](https://www.steinlab.org/) at the University of North Carolina.\n\nThe pipeline is mainly based on the NuMorph (Nuclear-Based Morphometry) toolbox developed by Krupa et al., 2021.\n\n> **NuMorph: Tools for cortical cellular phenotyping in tissue-cleared whole-brain images**\n>\n> Krupa O, Fragola G, Hadden-Ford E, Mory JT, Liu T, Humphrey Z, Rees BW, Krishnamurthy A, Snider WD, Zylka MJ, Wu G, Xing L, Stein JL.\n>\n> Cell Rep. 2021 Oct 12, doi: [10.1016/j.celrep.2021.109802](https://doi.org/10.1016%2Fj.celrep.2021.109802)\n\nWe thank the following people for their extensive assistance in the development of this pipeline:\n\n[Matthias H\u00f6rtenhuber](https://github.com/mashehu)\\\n[Famke B\u00e4uerle](https://github.com/famosab)\\\n[Mark Polster](https://github.com/mapo9)\\\n[Susi Jo](https://github.com/SusiJo)\\\n[Luis Kuhn Cuellar](https://github.com/luiskuhn)\\\n[Daniel Straub](https://github.com/d4straub)\\\n[Niklas Grote](https://github.com/HomoPolyethylen)\\\n[Jason Stein](https://www.steinlab.org/)\\\n[Felix Kyere](https://www.steinlab.org/)\\\n[Ian Curtin](https://www.steinlab.org/)\\\n[Tatiana Woller](https://github.com/tatianawoller) [(VIB)](https://bioimagingcore-leuven.sites.vib.be/en)\\\n[Irene Lamberti](https://github.com/irelamb) [(VIB)](https://bioimagingcore-leuven.sites.vib.be/en)\\\n[Benjamin Pavie](https://github.com/bpavie) [(VIB)](https://bioimagingcore-leuven.sites.vib.be/en)\n\n## Contributions and Support\n\nIf you would like to contribute to this pipeline, please see the [contributing guidelines](.github/CONTRIBUTING.md).\n\nFor further information or help, don't hesitate to get in touch on the [Slack `#lsmquant` channel](https://nfcore.slack.com/channels/lsmquant) (you can join with [this invite](https://nf-co.re/join/slack)).\n\n## Citations\n\n<!-- TODO nf-core: Add citation for pipeline after first release. Uncomment lines below and update Zenodo doi and badge at the top of this file. -->\n<!-- If you use nf-core/lsmquant for your analysis, please cite it using the following doi: [10.5281/zenodo.XXXXXX](https://doi.org/10.5281/zenodo.XXXXXX) -->\n\n<!-- TODO nf-core: Add bibliography of tools and data used in your pipeline -->\n\nAn extensive list of references for the tools used by the pipeline can be found in the [`CITATIONS.md`](CITATIONS.md) file.\n\nYou can cite the `nf-core` publication as follows:\n\n> **The nf-core framework for community-curated bioinformatics pipelines.**\n>\n> Philip Ewels, Alexander Peltzer, Sven Fillinger, Harshil Patel, Johannes Alneberg, Andreas Wilm, Maxime Ulysse Garcia, Paolo Di Tommaso & Sven Nahnsen.\n>\n> _Nat Biotechnol._ 2020 Feb 13. doi: [10.1038/s41587-020-0439-x](https://dx.doi.org/10.1038/s41587-020-0439-x).\n",
0 commit comments