Metadata-Version: 2.4
Name: cttools-chrysanthemum
Version: 0.2.0
Summary: CTtools: chrysanthemum transcriptome workflows for prebuilt and custom references
Author: songaiping
License: Proprietary
Requires-Python: >=3.10
Description-Content-Type: text/markdown

# CTtools

CTtools is a private transcriptome workflow toolkit for chrysanthemum projects.

## Design Priority

CTtools encourages users to provide their own reference genome (`FASTA`), annotation (`GFF/GTF`) and protein file (`PEP`) for transparent, reproducible analyses.

Prebuilt species resources are supported as convenience presets, but custom reference workflows are the default recommendation.

## Core Capabilities

- Build LSF/bsub scripts for RNA-seq workflows.
- Support two modes:
	- `custom`: user-provided references (recommended)
	- `prebuilt`: use registry-managed species resources
- Support stage-level script generation so users can run full workflow or only selected parts.

## Stage-Level Execution

You can generate scripts for full pipeline or partial pipeline via `--stages`.

- `prebuilt` allowed stages: `star`, `rsem`, `matrix`
- `custom` allowed stages: `agat`, `rsem_prep`, `star`, `rsem`, `matrix`

Example:

```bash
# custom full workflow (recommended)
python -m cttools lsf-workflow custom \
	--reference-fasta ./reference.fa \
	--reference-gff ./reference.gff \
	--reads-dir ./raw_reads \
	--out-root ./analysis_output \
	--script-dir ./lsf_scripts

# custom partial workflow (only mapping)
python -m cttools lsf-workflow custom \
	--reads-dir ./raw_reads \
	--out-root ./analysis_output \
	--script-dir ./lsf_scripts \
	--stages star

# prebuilt partial workflow (only matrix generation)
python -m cttools lsf-workflow prebuilt \
	--species cn_diploid_bramble_head \
	--reads-dir ./raw_reads \
	--out-root ./analysis_output \
	--script-dir ./lsf_scripts \
	--stages matrix
```

## Species Naming and Citation Attribution

The built-in prebuilt species registry has been updated to include official naming and citation notes to avoid attribution ambiguity.

- `Chrysanthemum morifolium (Cmo), hexaploid cultivar zhongshanzigui`
- `Chrysanthemum nankingense (Cn_A), diploid haplotype assembly`
- `Chrysanthemum nankingense (Cn_AB), diploid complete assembly`
- `Chrysanthemum seticuspe (CsGojo)`

Citation notes in registry:

- Song, A., Su, J., Wang, H. et al. Analyses of a chromosome-scale genome assembly reveal the origin and evolution of cultivated chrysanthemum. Nat Commun 14, 2021 (2023). DOI: `https://doi.org/10.1038/s41467-023-37730-3`
- Nakano M, Hirakawa H, Fukai E, et al. Communications Biology, 2021, 4(1):1167

## Quick Start

```bash
python -m pip install -e .
python -m cttools --help
python -m cttools registry list
```

## Repository Layout

- `src/cttools/`: core package
- `resources/`: external registry template
- `src/cttools/resources/`: packaged registry used by default
- `docs/`: architecture and requirement notes
- `tests/`: unit and integration tests
