Skip to content

Commit a73459a

Browse files
committed
update readme
1 parent d8a0a07 commit a73459a

File tree

1 file changed

+17
-14
lines changed

1 file changed

+17
-14
lines changed

README.md

Lines changed: 17 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -1,3 +1,4 @@
1+
[![Documentation Status](https://readthedocs.org/projects/moddotplot/badge/?version=latest)](https://moddotplot.readthedocs.io/en/latest/?badge=latest)
12
![](images/logo.png)
23

34
- [About](#about)
@@ -6,6 +7,7 @@
67
- [Interactive Mode](#interactive-mode)
78
- [Static Mode](#static-mode)
89
- [Standard arguments](#standard-arguments)
10+
- [Save matrix to file, but don't render plots. In interactive mode, this must be utlized with the `--save` flag.](#save-matrix-to-file-but-dont-render-plots-in-interactive-mode-this-must-be-utlized-with-the---save-flag)
911
- [Interactive Mode Commands](#interactive-mode-commands)
1012
- [Static Mode Commands](#static-mode-commands)
1113
- [Sample run - Interactive Mode](#sample-run---interactive-mode)
@@ -141,6 +143,8 @@ If set when 2 or more sequences are input into ModDotPlot, this will show an a v
141143
`--ambiguous <bool>`
142144
By default, k-mers that are homopolymers of ambiguous IUPAC codes (eg. NNNNNNNNNNN’s) are excluded from identity estimation. This results in gaps along the central diagonal for these regions. If desired, these can be kept by setting the `—-ambiguous` flag in both interactive and static mode.
143145

146+
`--no-plot <bool>`
147+
Save matrix to file, but don't render plots. In interactive mode, this must be utlized with the `--save` flag.
144148
---
145149

146150
### Interactive Mode Commands
@@ -151,7 +155,7 @@ Port to display ModDotPlot on. Default is 8050, this can be changed to any accep
151155

152156
`-w / --window <int>`
153157

154-
Minimum window size. By default, interactive mode sets a minimum window size based on the sequence length `n/2000` (eg. a 3Mbp sequence will have a 1500bp window). The maximum window size will always be set to `n/1000` (3000bp under the same example). This means that 2 matrices will be created. Creating more matrices will mean
158+
Minimum window size. By default, interactive mode sets a minimum window size based on the sequence length `n/2000` (eg. a 3Mbp sequence will have a 1500bp window). The maximum window size will always be set to `n/1000` (3000bp under the same example). This means that 2 matrices will be created.
155159

156160
`-q / --quick <bool>`
157161

@@ -185,10 +189,6 @@ Window size. Unlike interactive mode, only one matrix will be created, so this r
185189

186190
Skip output of bed file.
187191

188-
`--no-plot <bool>`
189-
190-
Skip output of pdf and png image files.
191-
192192
`--no-hist <bool>`
193193

194194
Skip output of histogram legend.
@@ -209,6 +209,10 @@ List of accepted palettes can be found [here](https://jiffyclub.github.io/palett
209209

210210
Flip sequential order of color palette. Set to `-` by default for divergent palettes.
211211

212+
`--color <list of hexcodes>`
213+
214+
List of custom colors in hexcode format can be entered sequentially, mapped from low to high identity.
215+
212216
`--breakpoints <list of ints>`
213217

214218
Add custom identity threshold breakpoints. Note that the number of breakpoints must be equal to the number of colors + 1.
@@ -278,7 +282,7 @@ ssh -N -f -L <LOCAL_PORT_NUMBER>:127.0.0.1:<HPC_PORT_NUMBER> [email protected]
278282

279283
You should now be able to view interactive mode using `http://127.0.0.1:<LOCAL_PORT_NUMBER>`. Note that your own HPC environment may have specific instructions and/or restrictions for setting up port forwarding.
280284

281-
VSCode now has automatic port forwarding built into the terminal menu. See [VSCode documentation](https://code.visualstudio.com/docs/editor/port-forwarding) for fruther details
285+
VSCode now has automatic port forwarding built into the terminal menu. See [VSCode documentation](https://code.visualstudio.com/docs/editor/port-forwarding) for further details
282286

283287
![](images/portforwarding.png)
284288

@@ -319,7 +323,7 @@ $ moddotplot static -c config/config.json
319323
| | | | (_) | (_| | | |__| | (_) | |_ | | | | (_) | |_
320324
|_| |_|\___/ \__,_| |_____/ \___/ \__| |_| |_|\___/ \__|
321325
322-
v0.8.0
326+
v0.8.1
323327
324328
Running ModDotPlot in static mode
325329
@@ -371,18 +375,17 @@ For bug reports or general usage questions, please raise a GitHub issue, or emai
371375

372376
## Known Issues
373377

374-
Plot width and xlim (limiting the x axis to a different amount) currently do not work. I plan to have those working in v0.9.0.
375-
376-
Mac users might encounter the following unexpected command line output:
378+
- Plot width and xlim (limiting the x axis to a different amount) currently do not work. I plan to have those working in v0.9.0.
377379

378-
`/bin/sh: lscpu: command not found`
379-
380-
This is a known issue with Plotnine, the Python plotting library used by ModDotPlot. This can be safely ignored.
380+
- Mac users might encounter the following unexpected command line output: `/bin/sh: lscpu: command not found`. This is a known issue with Plotnine, the Python plotting library used by ModDotPlot. This can be safely ignored.
381381

382+
- If you encounter an error with the following traceback: `rv = reductor(4) TypeError: cannot pickle 'generator' object`, ths means that you have a newer version of Plotnine that is incompatible with ModDotPlot. Please uninstall plotnine and reinstall version 0.12.4 `pip install plotnine==0.12.4`.
382383

384+
- In interactive mode, comparing sequences of two sizes will lead to errors in zooming for the larger sequence. I plan to fix this in v0.9.0.
385+
383386
---
384387

385388

386389
## Cite
387390

388-
Publication in progress!
391+
Publication in progress! (almost there :D)

0 commit comments

Comments
 (0)