File: obistat.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 (95 lines) | stat: -rw-r--r-- 2,606 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
82
83
84
85
86
87
88
89
90
91
92
93
94
95
.. automodule:: obistat
   
   :py:mod:`obistat` specific options
   ----------------------------------  

   .. cmdoption::  -c <KEY>, --category-attribute=<KEY>   
   
        Attribute used to categorize the sequence records. Several ``-c`` options can be combined. 
 
        .. TIP:: The ``<KEY>`` can be simply the key of an attribute, or a *Python* expression
                 similarly to the ``-p`` option of :py:mod:`obigrep`.

    *Example:*
    
    		.. code-block:: bash
    
       			> obistat -c sample -c seq_length seq.fasta
     
		This command prints the number of sequence records and total count for each combination of
		sample and sequence length.
   
             
   .. cmdoption::  -m <KEY>, --min=<KEY>  
   
		Computes the minimum value of attribute <KEY> for each category. 

   	*Example:*
        
    		.. code-block:: bash
    
       			> obistat -c sample -m seq_length seq.fastq
    
		This command computes the minimum sequence length observed for each sample.

   .. cmdoption::  -M <KEY>, --max=<KEY>  
   
		Computes the maximum value of attribute <KEY> for each category. 

   	*Example:*
        
    		.. code-block:: bash
    
       			> obistat -c sample -M seq_length seq.fastq
    
		This command computes the maximum sequence length observed for each sample.

   .. cmdoption::  -a <KEY>, --mean=<KEY>  

		Computes the mean value of attribute <KEY> for each category. 
	
	*Example:*
    
    		.. code-block:: bash
    
       			> obistat -c sample -a seq_length seq.fastq

		This command computes the mean sequence length observed for each sample.

	.. cmdoption::  -v <KEY>, --variance=<KEY>  

		Computes the variance of attribute <KEY> for each category. 
	
	*Example:*
    
    		.. code-block:: bash
    
       			> obistat -c genus_name -v reverse_error seq.fastq
	    
		This command computes the variance of the number of errors observed in the reverse primer for each genus.
			
	.. cmdoption::  -s <KEY>, -std-dev=<KEY>  
	   
		Computes the standard deviation of attribute <KEY> for each category. 
	
	*Example:*
    
    		.. code-block:: bash
    
       			> obistat -c genus_name -s reverse_error seq.fastq
	    
		This command computes the standard deviation of the number of errors observed in the reverse primer for each genus.


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

   .. include:: ../optionsSet/taxonomyDB.txt
   
   .. include:: ../optionsSet/defaultoptions.txt
   
   :py:mod:`obistat` used sequence attribute
   -----------------------------------------
   
              - :doc:`count <../attributes/count>`