File: obisubset.rst

package info (click to toggle)
obitools 1.2.13%2Bdfsg-5
  • links: PTS, VCS
  • area: main
  • in suites: bookworm
  • size: 4,652 kB
  • sloc: python: 18,199; ansic: 1,542; makefile: 98
file content (81 lines) | stat: -rw-r--r-- 2,182 bytes parent folder | download | duplicates (3)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
.. automodule:: obisubset
 

   :py:mod:`obisubset` specific options
   ------------------------------------

   .. cmdoption::  -s <TAGNAME>,  --sample=<TAGNAME>,

     The option ``-s`` allows to specify the tag containing sample descriptions,
     the default value is set to *merged_sample*.

     *Example:*

         .. code-block:: bash

             > obiuniq -m sample seq1.fasta > seq2.fasta
             > obisubset -s merged_sample -n sample1 seq2.fasta > seq3.fasta

         After the dereplication of the sequences using the
         in the new attribute ``merged_sample``.

   .. cmdoption::  -o <TAGNAME>,  --other-tag=<TAGNAME>,

     Another tag to clean according to the sample subset

     *Example:*

          .. code-block:: bash

              > obisubset -s merged_sample -o -n sample1 seq2.fasta > seq3.fasta

   .. cmdoption::  -l <FILENAME>,  --sample-list=<FILENAME>,

     File containing the samples names (one sample id per line).

     *Example:*

          .. code-block:: bash

              > obisubset -s merged_sample -o -l ids.txt seq2.fasta > seq3.fasta

   .. cmdoption::  -p <REGEX>,  --sample-pattern=<REGEX>,

     A regular expression pattern matching the sample ids to extract.

     *Example:*

         .. code-block:: bash

             > obisubset -s merged_sample -o -p "negative_.*" seq2.fasta > seq3.fasta

   .. cmdoption::  -n <SAMPLEIDS>,  --sample-name=<SAMPLEIDS>,

     A sample id to extract

     *Example:*

          .. code-block:: bash

              > obisubset -s merged_sample -o -n sample1 seq2.fasta > seq3.fasta

   .. include:: ../optionsSet/inputformat.txt

   .. include:: ../optionsSet/outputformat.txt

   .. include:: ../optionsSet/defaultoptions.txt

   :py:mod:`obisubset` modifies sequence attributes
   ------------------------------------------------

      .. hlist::
           :columns: 3

           - :doc:`count <../attributes/count>`
           - :doc:`merged_* <../attributes/merged_star>`

   :py:mod:`obisubset` used sequence attribute
   -------------------------------------------

           - :doc:`count <../attributes/taxid>`
           - :doc:`merged_* <../attributes/merged_star>`