uchime_src/help.h

   1 "\n"
   2 "Usage\n"
   3 "-----\n"
   4 "\n"
   5 "uchime --input query.fasta [--db db.fasta] [--uchimeout results.uchime]\n"
   6 "    [--uchimealns results.alns]\n"
   7 "\n"
   8 "Options\n"
   9 "-------\n"
  10 "\n"
  11 "--input filename\n"
  12 "    Query sequences in FASTA format.\n"
  13 "    If the --db option is not specificed, uchime uses de novo\n"
  14 "    detection. In de novo mode, relative abundance must be given\n"
  15 "    by a string /ab=xxx/ somewhere in the label, where xxx is a\n"
  16 "    floating-point number, e.g. >F00QGH67HG/ab=1.2/.\n"
  17 "\n"
  18 "--db filename\n"
  19 "    Reference database in FASTA format.\n"
  20 "    Optional, if not specified uchime uses de novo mode.\n"
  21 "\n"
  22 "    ***WARNING*** The database is searched ONLY on the plus strand.\n"
  23 "    You MUST include reverse-complemented sequences in the database\n"
  24 "    if you want both strands to be searched.\n"
  25 "\n"
  26 "--abskew x\n"
  27 "    Minimum abundance skew. Default 1.9. De novo mode only.\n"
  28 "    Abundance skew is:\n"
  29 "        min [ abund(parent1), abund(parent2) ] / abund(query).\n"
  30 "\n"
  31 "--uchimeout filename\n"
  32 "    Output in tabbed format with one record per query sequence.\n"
  33 "    First field is score (h), second field is query label.\n"
  34 "    For details, see manual.\n"
  35 "\n"
  36 "--uchimealns filename\n"
  37 "    Multiple alignments of query sequences to parents in human-\n"
  38 "    readable format. Alignments show columns with differences\n"
  39 "    that support or contradict a chimeric model.\n"
  40 "\n"
  41 "--minh h\n"
  42 "    Mininum score to report chimera. Default 0.3. Values from 0.1\n"
  43 "    to 5 might be reasonable. Lower values increase sensitivity\n"
  44 "    but may report more false positives. If you decrease --xn,\n"
  45 "    you may need to increase --minh, and vice versa.\n"
  46 "\n"
  47 "--mindiv div\n"
  48 "    Minimum divergence ratio, default 0.5. Div ratio is 100%% - \n"
  49 "    %%identity between query sequence and the closest candidate for\n"
  50 "    being a parent. If you don't care about very close chimeras,\n"
  51 "    then you could increase --mindiv to, say, 1.0 or 2.0, and\n"
  52 "    also decrease --min h, say to 0.1, to increase sensitivity.\n"
  53 "    How well this works will depend on your data. Best is to\n"
  54 "    tune parameters on a good benchmark.\n"
  55 "\n"
  56 "--xn beta\n"
  57 "    Weight of a no vote, also called the beta parameter. Default 8.0.\n"
  58 "    Decreasing this weight to around 3 or 4 may give better\n"
  59 "    performance on denoised data.\n"
  60 "\n"
  61 "--dn n\n"
  62 "    Pseudo-count prior on number of no votes. Default 1.4. Probably\n"
  63 "    no good reason to change this unless you can retune to a good\n"
  64 "    benchmark for your data. Reasonable values are probably in the\n"
  65 "    range from 0.2 to 2.\n"
  66 "\n"
  67 "--xa w\n"
  68 "    Weight of an abstain vote. Default 1. So far, results do not\n"
  69 "    seem to be very sensitive to this parameter, but if you have\n"
  70 "    a good training set might be worth trying. Reasonable values\n"
  71 "    might range from 0.1 to 2.\n"
  72 "\n"
  73 "--chunks n\n"
  74 "    Number of chunks to extract from the query sequence when searching\n"
  75 "    for parents. Default 4.\n"
  76 "\n"
  77 "--[no]ovchunks\n"
  78 "    [Do not] use overlapping chunks. Default do not.\n"
  79 "\n"
  80 "--minchunk n\n"
  81 "    Minimum length of a chunk. Default 64.\n"
  82 "\n"
  83 "--idsmoothwindow w\n"
  84 "    Length of id smoothing window. Default 32.\n"
  85 "\n"
  86 "--minsmoothid f\n"
  87 "    Minimum factional identity over smoothed window of candidate parent.\n"
  88 "    Default 0.95.\n"
  89 "\n"
  90 "--maxp n\n"
  91 "    Maximum number of candidate parents to consider. Default 2. In tests so\n"
  92 "    far, increasing --maxp gives only a very small improvement in sensivity\n"
  93 "    but tends to increase the error rate quite a bit.\n"
  94 "\n"
  95 "--[no]skipgaps\n"
  96 "--[no]skipgaps2\n"
  97 "    These options control how gapped columns affect counting of diffs.\n"
  98 "    If --skipgaps is specified, columns containing gaps do not found as diffs.\n"
  99 "    If --skipgaps2 is specified, if column is immediately adjacent to\n"
 100 "    a column containing a gap, it is not counted as a diff.\n"
 101 "    Default is --skipgaps --skipgaps2.\n"
 102 "\n"
 103 "--minlen L\n"
 104 "--maxlen L\n"
 105 "    Minimum and maximum sequence length. Defaults 10, 10000.\n"
 106 "    Applies to both query and reference sequences.\n"
 107 "\n"
 108 "--ucl\n"
 109 "    Use local-X alignments. Default is global-X. On tests so far, global-X\n"
 110 "    is always better; this option is retained because it just might work\n"
 111 "    well on some future type of data.\n"
 112 "\n"
 113 "--queryfract f\n"
 114 "    Minimum fraction of the query sequence that must be covered by a local-X\n"
 115 "    alignment. Default 0.5. Applies only when --ucl is specified.\n"
 116 "\n"
 117 "--quiet\n"
 118 "    Do not display progress messages on stderr.\n"
 119 "\n"
 120 "--log filename\n"
 121 "    Write miscellaneous information to the log file. Mostly of interest\n"
 122 "    to me (the algorithm developer). Use --verbose to get more info.\n"
 123 "\n"
 124 "--self\n"
 125 "    In reference database mode, exclude a reference sequence if it has\n"
 126 "    the same label as the query. This is useful for benchmarking by using\n"
 127 "    the ref db as a query to test for false positives.\n"