Reorganization of the documentation book directory

Former-commit-id: 095acaf9c8649b0e527c6253dc79330feedac865

doc/book/_freeze/commands/execute-results/html.json

@@ -0,0 +1,16 @@
+{
+  "hash": "44052e156ff134928de01c20aa868355",
+  "result": {
+    "markdown": "# The *OBITools V4* commands\n\n## Specifying the input files to *OBITools* commands\n\n## Options common to most of the *OBITools* commands\n\n### Specifying input format\n\nFive sequence formats are accepted for input files. *Fasta* (@sec-fasta) and *Fastq* (@sec-fastq) are the main ones, EMBL and Genbank allow the use of flat files produced by these two international databases. The last one, ecoPCR, is maintained for compatibility with previous *OBITools* and allows to read *ecoPCR* outputs as sequence files.\n\n-   `--ecopcr` : Read data following the *ecoPCR* output format.\n-   `--embl` Read data following the *EMBL* flatfile format.\n-   `--genbank` Read data following the *Genbank* flatfile format.\n\nSeveral encoding schemes have been proposed for quality scores in *Fastq* format. Currently, *OBITools* considers Sanger encoding as the standard. For reasons of compatibility with older datasets produced with *Solexa* sequencers, it is possible, by using the following option, to force the use of the corresponding quality encoding scheme when reading these older files.\n\n-   `--solexa` Decodes quality string according to the Solexa specification. (default: false)\n\n### Specifying output format\n\nOnly two output sequence formats are supported by OBITools, Fasta and Fastq. Fastq is used when output sequences are associated with quality information. Otherwise, Fasta is the default format. However, it is possible to force the output format by using one of the following two options. Forcing the use of Fasta results in the loss of quality information. Conversely, when the Fastq format is forced with sequences that have no quality data, dummy qualities set to 40 for each nucleotide are added.\n\n-   `--fasta-output` Read data following the ecoPCR output format.\n-   `--fastq-output` Read data following the EMBL flatfile format.\n\nOBITools allows multiple input files to be specified for a single command.\n\n-   `--no-order` When several input files are provided, indicates that there is no order among them. (default: false). \n                 Using such option can increase a lot the processing of the data.\n\n### The Fasta and Fastq annotations format\n\nOBITools extend the [Fasta](#the-fasta-sequence-format) and [Fastq](#the-fastq-sequence-format) formats by introducing a format for the title lines of these formats allowing to annotate every sequence. While the previous version of OBITools used an *ad-hoc* format for these annotation, this new version introduce the usage of the standard JSON format to store them.\n\nOn input, OBITools automatically recognize the format of the annotations, but two options allows to force the parsing following one of them. You should normally not need to use these options.\n\n-   `--input-OBI-header` FASTA/FASTQ title line annotations follow OBI format. (default: false)\n\n-   `--input-json-header` FASTA/FASTQ title line annotations follow json format. (default: false)\n\nOn output, by default annotation are formatted using the new JSON format. For compatibility with previous version of OBITools and with external scripts and software, it is possible to force the usage of the previous OBITools format.\n\n-   `--output-OBI-header|-O` output FASTA/FASTQ title line annotations follow OBI format. (default: false)\n\n-   `--output-json-header` output FASTA/FASTQ title line annotations follow json format. (default: false)\n\n#### System related options\n\n-   `--debug` (default: false)\n-   `--help\\|-h\\|-?` (default: false)\n-   `--max-cpu <int>` Number of parallele threads computing the result (default: 10)\n-   `--workers\\|-w <int>` Number of parallele threads computing the result (default: 9)\n\n## OBITools expression language\n\nSeveral OBITools (*e.g.* obigrep, obiannotate) allow the user to specify some simple expressions to compute values or define predicates. This expressions are parsed and evaluated using the [gval](https://pkg.go.dev/github.com/PaesslerAG/gval \"Gval (Go eVALuate) for evaluating arbitrary expressions Go-like expressions.\") go package, which allows for evaluating go-Like expression.\n\n### Variables usable in the expression\n\n- `sequence` is the sequence object on which the expression is evaluated.\n- `annotations`is a map object containing every annotations associated to the currently processed sequence.\n\n### Function defined in the language \n\n#### Instrospection functions {.unnumbered}\n\n- `len(x)`is a generic function allowing to retreive the size of a object. It returns \n  the length of a sequences, the number of element in a map like `annotations`, the number\n  of elements in an array. The reurned value is an `int`.\n\n#### Cast functions {.unnumbered}\n\n- `int(x)`  converts if possible the `x` value to an integer value. The function \n  returns an `int`.\n- `numeric(x)` converts if possible the `x` value to a float value. The function \n  returns a `float`.\n- `bool(x)` converts if possible the `x` value to a boolean vLine truncated
+    "supporting": [
+      "commands_files"
+    ],
+    "filters": [
+      "rmarkdown/pagebreak.lua"
+    ],
+    "includes": {},
+    "engineDependencies": {},
+    "preserve": {},
+    "postProcess": true
+  }
+}