diff --git a/docs/.doctrees/api/seismicrna.core.doctree b/docs/.doctrees/api/seismicrna.core.doctree index 1a66961a..75e6cc15 100644 Binary files a/docs/.doctrees/api/seismicrna.core.doctree and b/docs/.doctrees/api/seismicrna.core.doctree differ diff --git a/docs/.doctrees/api/seismicrna.core.seq.doctree b/docs/.doctrees/api/seismicrna.core.seq.doctree index 77064911..a03f1264 100644 Binary files a/docs/.doctrees/api/seismicrna.core.seq.doctree and b/docs/.doctrees/api/seismicrna.core.seq.doctree differ diff --git a/docs/.doctrees/api/seismicrna.core.seq.tests.doctree b/docs/.doctrees/api/seismicrna.core.seq.tests.doctree index 032531a3..14cf8dc8 100644 Binary files a/docs/.doctrees/api/seismicrna.core.seq.tests.doctree and b/docs/.doctrees/api/seismicrna.core.seq.tests.doctree differ diff --git a/docs/.doctrees/api/seismicrna.doctree b/docs/.doctrees/api/seismicrna.doctree index 07c7fef5..76263db4 100644 Binary files a/docs/.doctrees/api/seismicrna.doctree and b/docs/.doctrees/api/seismicrna.doctree differ diff --git a/docs/.doctrees/api/seismicrna.lists.doctree b/docs/.doctrees/api/seismicrna.lists.doctree new file mode 100644 index 00000000..4e165621 Binary files /dev/null and b/docs/.doctrees/api/seismicrna.lists.doctree differ diff --git a/docs/.doctrees/api/seismicrna.mask.doctree b/docs/.doctrees/api/seismicrna.mask.doctree index 3b56740e..7cf0e526 100644 Binary files a/docs/.doctrees/api/seismicrna.mask.doctree and b/docs/.doctrees/api/seismicrna.mask.doctree differ diff --git a/docs/.doctrees/api/seismicrna.table.doctree b/docs/.doctrees/api/seismicrna.table.doctree index af7ab4e3..82d21911 100644 Binary files a/docs/.doctrees/api/seismicrna.table.doctree and b/docs/.doctrees/api/seismicrna.table.doctree differ diff --git a/docs/.doctrees/api/seismicrna.wf.doctree b/docs/.doctrees/api/seismicrna.wf.doctree index 9d4b9264..21719194 100644 Binary files a/docs/.doctrees/api/seismicrna.wf.doctree and b/docs/.doctrees/api/seismicrna.wf.doctree differ diff --git a/docs/.doctrees/cli.doctree b/docs/.doctrees/cli.doctree index 9c5ef2c0..955d1d4d 100644 Binary files a/docs/.doctrees/cli.doctree and b/docs/.doctrees/cli.doctree differ diff --git a/docs/.doctrees/environment.pickle b/docs/.doctrees/environment.pickle index e0360211..a828d500 100644 Binary files a/docs/.doctrees/environment.pickle and b/docs/.doctrees/environment.pickle differ diff --git a/docs/.doctrees/formats/index.doctree b/docs/.doctrees/formats/index.doctree index 8c4ce9de..63b20d48 100644 Binary files a/docs/.doctrees/formats/index.doctree and b/docs/.doctrees/formats/index.doctree differ diff --git a/docs/.doctrees/formats/list/index.doctree b/docs/.doctrees/formats/list/index.doctree new file mode 100644 index 00000000..10cf3756 Binary files /dev/null and b/docs/.doctrees/formats/list/index.doctree differ diff --git a/docs/.doctrees/formats/list/listpos.doctree b/docs/.doctrees/formats/list/listpos.doctree new file mode 100644 index 00000000..826b986b Binary files /dev/null and b/docs/.doctrees/formats/list/listpos.doctree differ diff --git a/docs/.doctrees/formats/meta/index.doctree b/docs/.doctrees/formats/meta/index.doctree index 1716979c..a2c00bba 100644 Binary files a/docs/.doctrees/formats/meta/index.doctree and b/docs/.doctrees/formats/meta/index.doctree differ diff --git a/docs/.doctrees/formats/meta/joined.doctree b/docs/.doctrees/formats/meta/joined.doctree index 8eae232a..317e9ed4 100644 Binary files a/docs/.doctrees/formats/meta/joined.doctree and b/docs/.doctrees/formats/meta/joined.doctree differ diff --git a/docs/.doctrees/formats/meta/refs.doctree b/docs/.doctrees/formats/meta/refs.doctree index a53e00fa..4cae6ddc 100644 Binary files a/docs/.doctrees/formats/meta/refs.doctree and b/docs/.doctrees/formats/meta/refs.doctree differ diff --git a/docs/.doctrees/formats/meta/samples.doctree b/docs/.doctrees/formats/meta/samples.doctree index ab13b373..71ef2d91 100644 Binary files a/docs/.doctrees/formats/meta/samples.doctree and b/docs/.doctrees/formats/meta/samples.doctree differ diff --git a/docs/.doctrees/formats/meta/sections.doctree b/docs/.doctrees/formats/meta/sections.doctree index 5b4e42e7..958a82cb 100644 Binary files a/docs/.doctrees/formats/meta/sections.doctree and b/docs/.doctrees/formats/meta/sections.doctree differ diff --git a/docs/.doctrees/howto/run/mask.doctree b/docs/.doctrees/howto/run/mask.doctree index 520b3c4d..c4f8cf2a 100644 Binary files a/docs/.doctrees/howto/run/mask.doctree and b/docs/.doctrees/howto/run/mask.doctree differ diff --git a/docs/_sources/api/seismicrna.lists.rst.txt b/docs/_sources/api/seismicrna.lists.rst.txt new file mode 100644 index 00000000..5e192274 --- /dev/null +++ b/docs/_sources/api/seismicrna.lists.rst.txt @@ -0,0 +1,22 @@ +seismicrna.lists package +======================== + +.. automodule:: seismicrna.lists + :members: + :undoc-members: + :show-inheritance: + +Submodules +---------- + + +.. automodule:: seismicrna.lists.listpos + :members: + :undoc-members: + :show-inheritance: + + +.. automodule:: seismicrna.lists.lists + :members: + :undoc-members: + :show-inheritance: diff --git a/docs/_sources/api/seismicrna.rst.txt b/docs/_sources/api/seismicrna.rst.txt index df222676..f31d12e5 100644 --- a/docs/_sources/api/seismicrna.rst.txt +++ b/docs/_sources/api/seismicrna.rst.txt @@ -21,6 +21,7 @@ Subpackages seismicrna.fold seismicrna.graph seismicrna.join + seismicrna.lists seismicrna.mask seismicrna.pool seismicrna.relate diff --git a/docs/_sources/formats/index.rst.txt b/docs/_sources/formats/index.rst.txt index 710e0321..3896d11f 100644 --- a/docs/_sources/formats/index.rst.txt +++ b/docs/_sources/formats/index.rst.txt @@ -6,6 +6,7 @@ File Formats .. toctree:: :maxdepth: 2 - report/index data/index + list/index meta/index + report/index diff --git a/docs/_sources/formats/list/index.rst.txt b/docs/_sources/formats/list/index.rst.txt new file mode 100644 index 00000000..a4ecebab --- /dev/null +++ b/docs/_sources/formats/list/index.rst.txt @@ -0,0 +1,16 @@ + +List Formats +================================================================================ + +Using list files, one can list positions and reads that meet certain criteria, +as well as provide them to other commands. +All list files are in comma-separated values (CSV) format, which is advantageous +because it is both human-readable and widely supported by software including +Microsoft Excel and Python. +An example in CSV format is given for each type of list file. + + +.. toctree:: + :maxdepth: 2 + + listpos diff --git a/docs/_sources/formats/list/listpos.rst.txt b/docs/_sources/formats/list/listpos.rst.txt new file mode 100644 index 00000000..ed8c08ff --- /dev/null +++ b/docs/_sources/formats/list/listpos.rst.txt @@ -0,0 +1,58 @@ + +List of Positions +-------------------------------------------------------------------------------- + +List of Positions: Fields +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ + +========= ==== ========================================================= ======== +Name Type Description Required +========= ==== ========================================================= ======== +Reference str Name of the reference sequence yes +Position int Position in the reference sequence yes +... n/a Additional field (ignored) no +========= ==== ========================================================= ======== + +List of Positions file: Uses +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ + +List of Positions as input file +"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" + +- The ``mask`` command accepts a List of Positions file via ``--exclude-file``. + +List of Positions as output file +"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" + +- The ``+listpos`` command outputs a List of Positions file for each table file. + +Example List of Positions +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ + +List of Positions as a pretty table +"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" + +========= ======== +Reference Position +========= ======== +refA 11 +refA 16 +refA 20 +refB 11 +refB 46 +refB 83 +========= ======== + +List of Positions as plain text +"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" +:: + + Reference,Position + refA,11 + refA,16 + refA,20 + refB,11 + refB,46 + refB,83 + +This text can be copied into a new CSV file. diff --git a/docs/_sources/formats/meta/index.rst.txt b/docs/_sources/formats/meta/index.rst.txt index 5be575f4..9c0b8eca 100644 --- a/docs/_sources/formats/meta/index.rst.txt +++ b/docs/_sources/formats/meta/index.rst.txt @@ -1,12 +1,12 @@ Metadata Formats -======================================================================== +================================================================================ Using metadata files, information can be given about samples, reference sequences, and sections. -All metadata files must be in comma-separated values (CSV) format, which -is advantageous because it is both human-readable and widely supported -by software including Microsoft Excel and Python. +All metadata files are in comma-separated values (CSV) format, which is +advantageous because it is both human-readable and widely supported by software +including Microsoft Excel and Python. An example in CSV format is given for each type of metadata file. diff --git a/docs/_sources/formats/meta/joined.rst.txt b/docs/_sources/formats/meta/joined.rst.txt index 948ac87d..4022fb0c 100644 --- a/docs/_sources/formats/meta/joined.rst.txt +++ b/docs/_sources/formats/meta/joined.rst.txt @@ -40,12 +40,6 @@ joined cluster in the joined clusters metadata file. of ways to join those sections is *k*\ :sup:`n`. -Commands that use metadata for sections -"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" - -- ``seismic wf`` -- ``seismic join`` - Fields of metadata for joined clusters ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ diff --git a/docs/_sources/formats/meta/refs.rst.txt b/docs/_sources/formats/meta/refs.rst.txt index 5856580d..b23b6716 100644 --- a/docs/_sources/formats/meta/refs.rst.txt +++ b/docs/_sources/formats/meta/refs.rst.txt @@ -7,15 +7,10 @@ About metadata for references Purpose of metadata for references """""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" + Define metadata about reference sequences, such as the coordinates at which barcodes are located. -Commands that use metadata for references -"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" - -- ``seismic export`` - - Fields of metadata for references ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ @@ -33,7 +28,6 @@ Notes about metadata for references - Additional fields with arbitrary names can be given. Their data types will be inferred as strings, integers, or floats. - Example metadata for references ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ diff --git a/docs/_sources/formats/meta/samples.rst.txt b/docs/_sources/formats/meta/samples.rst.txt index e893589b..e4496cef 100644 --- a/docs/_sources/formats/meta/samples.rst.txt +++ b/docs/_sources/formats/meta/samples.rst.txt @@ -12,11 +12,6 @@ Define metadata about samples, such as the cell line or buffer in which the RNA was probed, the type and concentration of the chemical probe, and the temperature during chemical probing. -Commands that use metadata for samples -"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" - -- ``seismic export`` - Fields of metadata for samples ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ diff --git a/docs/_sources/formats/meta/sections.rst.txt b/docs/_sources/formats/meta/sections.rst.txt index 129efebd..4ae147c3 100644 --- a/docs/_sources/formats/meta/sections.rst.txt +++ b/docs/_sources/formats/meta/sections.rst.txt @@ -14,13 +14,6 @@ and traceable to define the sections in a file than on the command line, using the option ``--sections-file`` (``-s``). The sections file additionally permits giving each section a name. -Commands that use metadata for sections -"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" - -- ``seismic wf`` -- ``seismic mask`` -- ``seismic fold`` - Fields of metadata for sections ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ diff --git a/docs/_sources/howto/run/mask.rst.txt b/docs/_sources/howto/run/mask.rst.txt index bea0e7be..cfe9a379 100644 --- a/docs/_sources/howto/run/mask.rst.txt +++ b/docs/_sources/howto/run/mask.rst.txt @@ -101,10 +101,8 @@ Exclude arbitary positions You can also exclude any arbitary positions from any reference sequence. A common reason to exclude a position is if the base is modified endogenously in a way that causes mutations during reverse transcription. -To exclude an arbitrary position, use ``--exclude-pos`` followed by the name of -the reference and the position to exclude. -For example, ``--exclude-pos lititz 48`` would exclude positions 48 from the -reference "lititz". +To exclude an arbitrary position, use ``--exclude-file`` followed by a file of +all positions to exclude, in :doc:`../../formats/list/listpos` format. Mask setting: Filter reads """""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" diff --git a/docs/api/seismicrna.align.html b/docs/api/seismicrna.align.html index 6fafeda3..69d68b90 100644 --- a/docs/api/seismicrna.align.html +++ b/docs/api/seismicrna.align.html @@ -66,6 +66,7 @@
Version information for SEISMIC-RNA
Mask the integer positions in the array mask_pos.
name (str
) – Name of the mask.
mask_pos (Iterable[int]
) – Positions to mask (1-indexed).
invert (bool = False
) – If invert is False, then mask out the positions in mask_pos.
-If True, then mask out all but the given positions.
complement (bool = False
) – If False, then remove the positions in mask_pos. Otherwise,
+remove all but those positions.
Return an identical section.
+Bases: unittest.case.TestCase
Bases: unittest.case.TestCase