Skip to content
This repository was archived by the owner on Mar 17, 2023. It is now read-only.

Commit 97ee1c9

Browse files
rename sencha to orpheum
1 parent fe04a91 commit 97ee1c9

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

51 files changed

+363
-159
lines changed

.github/pull_request_template.md

+1-1
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
1-
Many thanks to contributing to czbiohub/sencha!
1+
Many thanks to contributing to czbiohub/orpheum!
22

33
Please fill in the appropriate checklist below (delete whatever is not relevant). These are the most common things requested on pull requests (PRs).
44

.gitignore

+1-1
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
*.py[cod]
22

33
# autogenerated versioning file
4-
sencha/version.py
4+
orpheum/version.py
55

66
# C extensions
77
*.so

CONTRIBUTING.md

+9-9
Original file line numberDiff line numberDiff line change
@@ -10,7 +10,7 @@ Types of Contributions
1010

1111
### Report Bugs
1212

13-
Report bugs at <https://github.com/>czbiohub/sencha/issues.
13+
Report bugs at <https://github.com/>czbiohub/orpheum/issues.
1414

1515
If you are reporting a bug, please include:
1616

@@ -34,7 +34,7 @@ even on the web in blog posts, articles, and such.
3434

3535
### Submit Feedback
3636

37-
The best way to send feedback is to file an issue at <https://github.com/>czbiohub/sencha/issues.
37+
The best way to send feedback is to file an issue at <https://github.com/>czbiohub/orpheum/issues.
3838

3939
If you are proposing a feature:
4040

@@ -45,18 +45,18 @@ If you are proposing a feature:
4545
Get Started!
4646
------------
4747

48-
Ready to contribute? Here's how to set up sencha for
48+
Ready to contribute? Here's how to set up orpheum for
4949
local development.
5050

51-
1. Fork the sencha repo on GitHub.
51+
1. Fork the orpheum repo on GitHub.
5252
2. Clone your fork locally:
5353

54-
$ git clone [email protected]:your_name_here/sencha.git
54+
$ git clone [email protected]:your_name_here/orpheum.git
5555

5656
3. Install your local copy into a virtualenv. Assuming you have virtualenvwrapper installed, this is how you set up your fork for local development:
5757

58-
$ mkvirtualenv sencha
59-
$ cd sencha/
58+
$ mkvirtualenv orpheum
59+
$ cd orpheum/
6060
$ python setup.py develop
6161

6262
4. Create a branch for local development:
@@ -72,7 +72,7 @@ local development.
7272
$ py.test
7373
$ tox
7474

75-
To get black and tox, just pip install them into your virtualenv. Note: run formatting commands from the top sencha directory.
75+
To get black and tox, just pip install them into your virtualenv. Note: run formatting commands from the top orpheum directory.
7676

7777
6. Commit your changes and push your branch to GitHub:
7878

@@ -90,7 +90,7 @@ Before you submit a pull request, check that it meets these guidelines:
9090
1. The pull request should include tests.
9191
2. If the pull request adds functionality, the docs should be updated. Put your new functionality into a function with a docstring, and add the feature to the list in README.rst.
9292
3. The pull request should work for Python 3.6 and 3.7. Check
93-
<https://travis-ci.org/>czbiohub/sencha/pull\_requests and make sure that the tests pass
93+
<https://travis-ci.org/>czbiohub/orpheum/pull\_requests and make sure that the tests pass
9494
for all supported Python versions.
9595

9696
Tips

MANIFEST.in

+1-1
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
include LICENSE Makefile README.md HISTORY.md CONTRIBUTING.md AUTHORS.md requirements.txt
22

3-
recursive-include sencha/tests *
3+
recursive-include orpheum/tests *
44
recursive-exclude * __pycache__
55
recursive-exclude * *.py[co]
66

Makefile

+2-2
Original file line numberDiff line numberDiff line change
@@ -8,14 +8,14 @@ test:
88
py.test
99

1010
coverage:
11-
coverage run --source sencha --omit="*/test*" --module py.test
11+
coverage run --source orpheum --omit="*/test*" --module py.test
1212
coverage report --show-missing
1313

1414
lint:
1515
# ignore:
1616
# E126 continuation line over-indented for hanging indent
1717
# E127 continuation line over-indented for visual indent
18-
flake8 --exclude docs,tests --ignore=E127,E126 sencha
18+
flake8 --exclude docs,tests --ignore=E127,E126 orpheum
1919

2020
conda_install:
2121
conda install --file conda_requirements.txt

README.md

+16-20
Original file line numberDiff line numberDiff line change
@@ -1,37 +1,33 @@
1-
sencha
1+
orpheum
22
================================
3-
![Tests](https://github.com/czbiohub/sencha/workflows/Pytest/badge.svg)
4-
![Linting](https://github.com/czbiohub/sencha/workflows/Lint%20with%20flake8/badge.svg)
5-
[![codecov](https://codecov.io/gh/czbiohub/sencha/branch/master/graph/badge.svg)](https://codecov.io/gh/czbiohub/sencha)
3+
![Tests](https://github.com/czbiohub/orpheum/workflows/Pytest/badge.svg)
4+
![Linting](https://github.com/czbiohub/orpheum/workflows/Lint%20with%20flake8/badge.svg)
5+
[![codecov](https://codecov.io/gh/czbiohub/orpheum/branch/master/graph/badge.svg)](https://codecov.io/gh/czbiohub/orpheum)
66

7-
What is sencha?
7+
What is orpheum?
88
-------------------------------------
99

1010
Sencha is a Python package for directly translating RNA-seq reads into coding protein sequence.
1111

1212
- Free software: MIT license
13-
- Documentation: https://czbiohub.github.io/sencha
14-
15-
The name is inspired from the naming pattern of [sourmash](https://github.com/dib-lab/sourmash)
16-
combined with [@olgabot](https://github.com/olgabot/)'s love of tea.
17-
([Sencha](https://en.wikipedia.org/wiki/Sencha) is a Japanese green tea.)
13+
- Documentation: https://czbiohub.github.io/orpheum
1814

1915
Installation
2016
------------
2117

2218
The package can be installed from PyPI using `pip` here:
2319

2420
```
25-
pip install sencha
21+
pip install orpheum
2622
```
2723

2824
### Developmental install
2925

3026
To install this code and play around with the code locally, clone this github repository and use `pip` to install:
3127

3228
```
33-
git clone https://github.com/czbiohub/sencha.git
34-
cd sencha
29+
git clone https://github.com/czbiohub/orpheum.git
30+
cd orpheum
3531
3632
# The "." means "install *this*, the folder where I am now"
3733
pip install .
@@ -45,7 +41,7 @@ Usage
4541
A reference proteome *must* be supplied as the first argument.
4642

4743
```
48-
sencha translate reference-proteome.fa.gz *.fastq.gz > coding_peptides.fasta
44+
orpheum translate reference-proteome.fa.gz *.fastq.gz > coding_peptides.fasta
4945
```
5046

5147
#### Save the "coding scores" to a csv or parquet file
@@ -59,12 +55,12 @@ see the coding scores for all reads, use the `--csv` flag or `--parquet` flag.
5955

6056
csv:
6157
```
62-
sencha translate --csv coding_scores.csv reference-proteome.fa.gz *.fastq.gz > coding_peptides.fasta
58+
orpheum translate --csv coding_scores.csv reference-proteome.fa.gz *.fastq.gz > coding_peptides.fasta
6359
```
6460

6561
parquet:
6662
```
67-
sencha translate --parquet coding_scores.parquet reference-proteome.fa.gz *.fastq.gz > coding_peptides.fasta
63+
orpheum translate --parquet coding_scores.parquet reference-proteome.fa.gz *.fastq.gz > coding_peptides.fasta
6864
```
6965

7066
#### Save the coding nucleotides to a fasta
@@ -73,7 +69,7 @@ By default, only the coding *peptides* are output. If you'd like to also output
7369
the underlying *nucleotide* sequence, then use the flag `--coding-nucleotide-fasta`
7470

7571
```
76-
sencha translate --coding-nucleotide-fasta coding_nucleotides.fasta reference-proteome.fa.gz *.fastq.gz > coding_peptides.fasta
72+
orpheum translate --coding-nucleotide-fasta coding_nucleotides.fasta reference-proteome.fa.gz *.fastq.gz > coding_peptides.fasta
7773
```
7874

7975
#### Save the *non*-coding nucleotides to a fasta
@@ -82,7 +78,7 @@ To see the sequence of reads which were deemed non-coding, use the flag
8278
`--noncoding-nucleotide-fasta`.
8379

8480
```
85-
sencha translate --noncoding-nucleotide-fasta noncoding_nucleotides.fasta reference-proteome.fa.gz *.fastq.gz > coding_peptides.fasta
81+
orpheum translate --noncoding-nucleotide-fasta noncoding_nucleotides.fasta reference-proteome.fa.gz *.fastq.gz > coding_peptides.fasta
8682
```
8783

8884
#### Save the low complexity nucleotides to a fasta
@@ -98,7 +94,7 @@ would be considered low complexity. While this sequence has many nucleotide
9894
k-mers, it is likely a result of a sequencing error and we ignore it.
9995

10096
```
101-
sencha translate --low-complexity-nucleotide-fasta low_complexity_nucleotides.fasta reference-proteome.fa.gz *.fastq.gz > coding_peptides.fasta
97+
orpheum translate --low-complexity-nucleotide-fasta low_complexity_nucleotides.fasta reference-proteome.fa.gz *.fastq.gz > coding_peptides.fasta
10298
```
10399

104100
#### Save the low complexity peptides to a fasta
@@ -121,6 +117,6 @@ sequence of low-complexity peptides to a fasta, use the flag
121117
`--low-complexity-peptides-fasta`.
122118

123119
```
124-
sencha translate --low-complexity-peptides-fasta low_complexity_peptides.fasta reference-proteome.fa.gz *.fastq.gz > coding_peptides.fasta
120+
orpheum translate --low-complexity-peptides-fasta low_complexity_peptides.fasta reference-proteome.fa.gz *.fastq.gz > coding_peptides.fasta
125121
```
126122

docs/Makefile

+2-2
Original file line numberDiff line numberDiff line change
@@ -48,7 +48,7 @@ help:
4848

4949
clean:
5050
rm -rf $(BUILDDIR)
51-
rm -rf sencha*.rst
51+
rm -rf orpheum*.rst
5252
rm -rf modules.rst
5353
rm -rf tutorial/*.rst
5454
rm -rf tutorial/*_files
@@ -60,7 +60,7 @@ clean:
6060
html:
6161
cp ../examples/*.ipynb tutorial/;
6262
cd tutorial ; make notebooks ; cd ..
63-
sphinx-apidoc -l -d 4 -e --force -o . ../sencha
63+
sphinx-apidoc -l -d 4 -e --force -o . ../orpheum
6464
$(SPHINXBUILD) -b html $(ALLSPHINXOPTS) $(BUILDDIR)/html
6565
@echo
6666
@echo "Build finished. The HTML pages are in $(BUILDDIR)/html."

docs/conf.py

+10-10
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
#!/usr/bin/env python
22
# -*- coding: utf-8 -*-
33
#
4-
# sencha documentation build configuration file, created by
4+
# orpheum documentation build configuration file, created by
55
# sphinx-quickstart on Tue Jul 9 22:26:36 2013.
66
#
77
# This file is execfile()d with the current directory set to its
@@ -31,7 +31,7 @@
3131
# version is used.
3232
sys.path.insert(0, project_root)
3333

34-
import sencha
34+
import orpheum
3535

3636
# -- General configuration ---------------------------------------------
3737

@@ -63,9 +63,9 @@
6363
# the built documents.
6464
#
6565
# The short X.Y version.
66-
version = sencha.__version__
66+
version = orpheum.__version__
6767
# The full version, including alpha/beta/rc tags.
68-
release = sencha.__version__
68+
release = orpheum.__version__
6969

7070
# The language for content autogenerated by Sphinx. Refer to documentation
7171
# for a list of supported languages.
@@ -188,7 +188,7 @@
188188
# html_file_suffix = None
189189

190190
# Output file base name for HTML help builder.
191-
htmlhelp_basename = "senchadoc"
191+
htmlhelp_basename = "orpheumdoc"
192192

193193

194194
# -- Options for LaTeX output ------------------------------------------
@@ -208,8 +208,8 @@
208208
latex_documents = [
209209
(
210210
"index",
211-
"sencha.tex",
212-
u"sencha Documentation",
211+
"orpheum.tex",
212+
u"orpheum Documentation",
213213
u"Chan Zuckerberg Biohub",
214214
"manual",
215215
),
@@ -241,7 +241,7 @@
241241
# One entry per manual page. List of tuples
242242
# (source start file, name, description, authors, manual section).
243243
man_pages = [
244-
("index", "sencha", u"Sencha Documentation", [u"Chan Zuckerberg Biohub"], 1)
244+
("index", "orpheum", u"Sencha Documentation", [u"Chan Zuckerberg Biohub"], 1)
245245
]
246246

247247
# If true, show URL addresses after external links.
@@ -256,10 +256,10 @@
256256
texinfo_documents = [
257257
(
258258
"index",
259-
"sencha",
259+
"orpheum",
260260
u"Sencha Documentation",
261261
u"Chan Zuckerberg Biohub",
262-
"sencha",
262+
"orpheum",
263263
"Sencha is a Python package for directly translating RNA-seq reads into coding protein sequence.",
264264
"Miscellaneous",
265265
),

docs/index.rst

+1-1
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
1-
.. sencha documentation master file, created by
1+
.. orpheum documentation master file, created by
22
sphinx-quickstart on Tue Jul 9 22:26:36 2013.
33
You can adapt this file completely to your liking, but it should at least
44
contain the root `toctree` directive.

docs/installation.rst

+3-3
Original file line numberDiff line numberDiff line change
@@ -4,9 +4,9 @@ Installation
44

55
At the command line::
66

7-
$ easy_install sencha
7+
$ easy_install orpheum
88

99
Or, if you have virtualenvwrapper installed::
1010

11-
$ mkvirtualenv sencha
12-
$ pip install sencha
11+
$ mkvirtualenv orpheum
12+
$ pip install orpheum

docs/tutorial.rst

+1-1
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
.. _tutorial:
22

3-
sencha Tutorial
3+
orpheum Tutorial
44
=================
55

66
Installation

docs/usage.md

+5-5
Original file line numberDiff line numberDiff line change
@@ -2,21 +2,21 @@
22
Usage
33
========
44

5-
To use sencha in a project::
5+
To use orpheum in a project::
66

7-
import sencha
7+
import orpheum
88

99
To create a protein index::
1010

11-
sencha index --molecule protein --peptide-ksize 7 --save-as Homo_sapiens.GRCh38.pep.subset.molecule-protein_ksize-7.bloomfilter.nodegraph Homo_sapiens.GRCh38.pep.subset.fa.gz
11+
orpheum index --molecule protein --peptide-ksize 7 --save-as Homo_sapiens.GRCh38.pep.subset.molecule-protein_ksize-7.bloomfilter.nodegraph Homo_sapiens.GRCh38.pep.subset.fa.gz
1212

1313
To translate RNA-seq reads into coding peptides using the protein index::
1414

15-
sencha translate -- SRR306838_GSM752691_hsa_br_F_1_trimmed_subsampled.fq.gz Homo_sapiens.GRCh38.pep.all.fa.gz
15+
orpheum translate -- SRR306838_GSM752691_hsa_br_F_1_trimmed_subsampled.fq.gz Homo_sapiens.GRCh38.pep.all.fa.gz
1616

1717
To create the index and translate the reads in one step::
1818

19-
sencha partition ~/code/kmer-hashing/extract_kmers/test-data/SRR306838_GSM752691_hsa_br_F_1_trimmed_subsampled.fq.gz ~/Downloads/Homo_sapiens.GRCh38.pep.all.fa.gz
19+
orpheum partition ~/code/kmer-hashing/extract_kmers/test-data/SRR306838_GSM752691_hsa_br_F_1_trimmed_subsampled.fq.gz ~/Downloads/Homo_sapiens.GRCh38.pep.all.fa.gz
2020

2121

2222

0 commit comments

Comments
 (0)