|
a |
|
b/docs/wiki-Home.md |
|
|
1 |
# Welcome to the DNAnalyzer Wiki! |
|
|
2 |
|
|
|
3 |
 |
|
|
4 |
|
|
|
5 |
> DNAnalyzer identifies proteins, amino acids, start and stop codons, high coverage regions, and regulatory elements. |
|
|
6 |
> Researchers are working to extract valuable information to better understand human health and disease. |
|
|
7 |
> Currently, we are developing a Command-Line Interface (CLI) and a Graphical User Interface (GUI) to enable physicians |
|
|
8 |
> to quickly identify genetic mutations. |
|
|
9 |
|
|
|
10 |
## Documents |
|
|
11 |
[View Documents](https://github.com/VerisimilitudeX/DNAnalyzer/tree/main/docs) |
|
|
12 |
|
|
|
13 |
## Contributing |
|
|
14 |
|
|
|
15 |
### Steps to follow 📜 |
|
|
16 |
|
|
|
17 |
1. **Fork it 🍴** |
|
|
18 |
Get your own fork of [DNAnalyzer](https://github.com/VerisimilitudeX/DNAnalyzer) by using the `Fork` button at the top right of this page. |
|
|
19 |
 |
|
|
20 |
|
|
|
21 |
2. **Clone it 👥** |
|
|
22 |
Clone your fork to your local machine: |
|
|
23 |
```bash |
|
|
24 |
git clone https://github.com/Your_Username/DNAnalyzer.git |
|
|
25 |
cd DNAnalyzer |
|
|
26 |
``` |
|
|
27 |
Then, add a reference to the original repository: |
|
|
28 |
```bash |
|
|
29 |
git remote add upstream https://github.com/theabhishek07/DNAnalyzer.git |
|
|
30 |
git remote -v |
|
|
31 |
``` |
|
|
32 |
|
|
|
33 |
3. **Sync with the Remote 🔄** |
|
|
34 |
Keep your local repository up-to-date: |
|
|
35 |
```bash |
|
|
36 |
git fetch --all --prune |
|
|
37 |
git checkout main |
|
|
38 |
git reset --hard upstream/main |
|
|
39 |
git push origin main |
|
|
40 |
``` |
|
|
41 |
|
|
|
42 |
4. **Create a new branch** |
|
|
43 |
Create a new branch for your contribution: |
|
|
44 |
```bash |
|
|
45 |
git checkout -b <branchname> |
|
|
46 |
``` |
|
|
47 |
To switch branches later: |
|
|
48 |
```bash |
|
|
49 |
git checkout <branchname> |
|
|
50 |
``` |
|
|
51 |
Add changes and commit: |
|
|
52 |
```bash |
|
|
53 |
git add . |
|
|
54 |
git commit -m "your commit message" |
|
|
55 |
``` |
|
|
56 |
Push your branch: |
|
|
57 |
```bash |
|
|
58 |
git push -u origin <branchname> |
|
|
59 |
``` |
|
|
60 |
Finally, in your browser, navigate to your repository, click **Contribute**, and then **Open Pull Request**. Provide a concise title and description describing your contribution. |
|
|
61 |
|
|
|
62 |
### Contribution Guideline |
|
|
63 |
|
|
|
64 |
- ⭐ Drop a star on the GitHub repository (optional). |
|
|
65 |
- Before contributing, please read [`Contributing_Guidelines.md`](Contributing_Guidelines.md) and [`CODE_OF_CONDUCT.md`](CODE_OF_CONDUCT.md). |
|
|
66 |
- Create an issue or propose a feature/bug fix. |
|
|
67 |
- Fork the repo, clone it, create a branch, add your changes, commit, and push. |
|
|
68 |
- Make a pull request comparing your branch with the main branch of the repository. |
|
|
69 |
|
|
|
70 |
## Usage |
|
|
71 |
|
|
|
72 |
### Command-Line Interface (CLI) Usage |
|
|
73 |
|
|
|
74 |
DNAnalyzer uses CLI arguments instead of standard input. For example: |
|
|
75 |
```bash |
|
|
76 |
<executable> assets/dna/random/dnalong.fa --amino=ser |
|
|
77 |
``` |
|
|
78 |
or |
|
|
79 |
```bash |
|
|
80 |
<executable> assets/dna/random/dnalong.fa --amino=ser --min=0 --max=100 |
|
|
81 |
``` |
|
|
82 |
To view the help message: |
|
|
83 |
```bash |
|
|
84 |
<executable> --help |
|
|
85 |
|
|
|
86 |
# Output: |
|
|
87 |
Usage: DNAnalyzer [-hrV] --amino=<aminoAcid> [--find=<proteinFile>] [--max=<maxCount>] [--min=<minCount>] DNA |
|
|
88 |
DNA The FASTA file to be analyzed. |
|
|
89 |
--amino=<aminoAcid> The amino acid representing the start of a gene. |
|
|
90 |
--find=<proteinFile> The DNA sequence to be found. |
|
|
91 |
-h, --help Show this help message and exit. |
|
|
92 |
--max=<maxCount> Maximum count of the reading frame. |
|
|
93 |
--min=<minCount> Minimum count of the reading frame. |
|
|
94 |
-r, --reverse Reverse the DNA sequence before processing. |
|
|
95 |
-V, --version Print version information and exit. |
|
|
96 |
``` |
|
|
97 |
|
|
|
98 |
## Reports |
|
|
99 |
|
|
|
100 |
- [Key Personnel and Knowledge Distribution](https://github.com/VerisimilitudeX/DNAnalyzer/blob/936181dd714855276ea34f55b94e5b53afc8ef0e/docs/reports/key-personnel-and-and-knowledge-distribution.pdf) |
|
|
101 |
- [Technical Health Overview](https://github.com/VerisimilitudeX/DNAnalyzer/blob/936181dd714855276ea34f55b94e5b53afc8ef0e/docs/reports/technical-health-overview.pdf) |
|
|
102 |
- [Trend Report](https://github.com/VerisimilitudeX/DNAnalyzer/blob/936181dd714855276ea34f55b94e5b53afc8ef0e/docs/reports/trend-report.pdf) |
|
|
103 |
|
|
|
104 |
## Samples |
|
|
105 |
|
|
|
106 |
- [Serine DNAlong](https://github.com/VerisimilitudeX/DNAnalyzer/blob/936181dd714855276ea34f55b94e5b53afc8ef0e/docs/samples/serine-dnalong.md) |