2023-02-18 19:54:21 +01:00
<!DOCTYPE html>
< html xmlns = "http://www.w3.org/1999/xhtml" lang = "en" xml:lang = "en" > < head >
< meta charset = "utf-8" >
< meta name = "generator" content = "quarto-1.2.256" >
< meta name = "viewport" content = "width=device-width, initial-scale=1.0, user-scalable=yes" >
2024-01-04 14:17:44 +01:00
< title > OBITools V4 - 4 Specifying the data input to OBITools commands< / title >
2023-02-18 19:54:21 +01:00
< style >
code { white-space : pre-wrap ; }
span . smallcaps { font-variant : small-caps ; }
div . columns { display : flex ; gap : min ( 4 vw , 1.5 em ) ; }
div . column { flex : auto ; overflow-x : auto ; }
div . hanging-indent { margin-left : 1.5 em ; text-indent : -1.5 em ; }
ul . task-list { list-style : none ; }
ul . task-list li input [ type = "checkbox" ] {
2024-01-04 14:17:44 +01:00
width : 0.8 em ;
margin : 0 0.8 em 0.2 em -1.6 em ;
vertical-align : middle ;
2023-02-18 19:54:21 +01:00
}
< / style >
2024-01-04 14:17:44 +01:00
< script src = "site_libs/quarto-nav/quarto-nav.js" > < / script >
< script src = "site_libs/quarto-nav/headroom.min.js" > < / script >
< script src = "site_libs/clipboard/clipboard.min.js" > < / script >
< script src = "site_libs/quarto-search/autocomplete.umd.js" > < / script >
< script src = "site_libs/quarto-search/fuse.min.js" > < / script >
< script src = "site_libs/quarto-search/quarto-search.js" > < / script >
2023-02-18 19:54:21 +01:00
< meta name = "quarto:offset" content = "./" >
2024-01-04 14:17:44 +01:00
< link href = "./output.html" rel = "next" >
< link href = "./commands.html" rel = "prev" >
< script src = "site_libs/quarto-html/quarto.js" > < / script >
< script src = "site_libs/quarto-html/popper.min.js" > < / script >
< script src = "site_libs/quarto-html/tippy.umd.min.js" > < / script >
< script src = "site_libs/quarto-html/anchor.min.js" > < / script >
< link href = "site_libs/quarto-html/tippy.css" rel = "stylesheet" >
< link href = "site_libs/quarto-html/quarto-syntax-highlighting.css" rel = "stylesheet" id = "quarto-text-highlighting-styles" >
< script src = "site_libs/bootstrap/bootstrap.min.js" > < / script >
< link href = "site_libs/bootstrap/bootstrap-icons.css" rel = "stylesheet" >
< link href = "site_libs/bootstrap/bootstrap.min.css" rel = "stylesheet" id = "quarto-bootstrap" data-mode = "light" >
2023-02-18 19:54:21 +01:00
< script id = "quarto-search-options" type = "application/json" > {
"location" : "sidebar" ,
"copy-button" : false ,
"collapse-after" : 3 ,
"panel-placement" : "start" ,
"type" : "textbox" ,
"limit" : 20 ,
"language" : {
"search-no-results-text" : "No results" ,
"search-matching-documents-text" : "matching documents" ,
"search-copy-link-title" : "Copy link to search" ,
"search-hide-matches-text" : "Hide additional matches" ,
"search-more-match-text" : "more match in this document" ,
"search-more-matches-text" : "more matches in this document" ,
"search-clear-button-title" : "Clear" ,
"search-detached-cancel-button-title" : "Cancel" ,
"search-submit-button-title" : "Submit"
}
} < / script >
< / head >
< body class = "nav-sidebar floating" >
< div id = "quarto-search-results" > < / div >
< header id = "quarto-header" class = "headroom fixed-top" >
< nav class = "quarto-secondary-nav" data-bs-toggle = "collapse" data-bs-target = "#quarto-sidebar" aria-controls = "quarto-sidebar" aria-expanded = "false" aria-label = "Toggle sidebar navigation" onclick = "if (window.quartoToggleHeadroom) { window.quartoToggleHeadroom(); }" >
< div class = "container-fluid d-flex justify-content-between" >
2024-01-04 14:17:44 +01:00
< h1 class = "quarto-secondary-nav-title" > < span class = "chapter-number" > 4< / span > < span class = "chapter-title" > Specifying the data input to < em > OBITools< / em > commands< / span > < / h1 >
2023-02-18 19:54:21 +01:00
< button type = "button" class = "quarto-btn-toggle btn" aria-label = "Show secondary navigation" >
< i class = "bi bi-chevron-right" > < / i >
< / button >
< / div >
< / nav >
< / header >
<!-- content -->
< div id = "quarto-content" class = "quarto-container page-columns page-rows-contents page-layout-article" >
<!-- sidebar -->
< nav id = "quarto-sidebar" class = "sidebar collapse sidebar-navigation floating overflow-auto" >
< div class = "pt-lg-2 mt-2 text-left sidebar-header" >
< div class = "sidebar-title mb-0 py-0" >
< a href = "./" > OBITools V4< / a >
< / div >
< / div >
< div class = "mt-2 flex-shrink-0 align-items-center" >
< div class = "sidebar-search" >
2024-01-04 14:17:44 +01:00
< div id = "quarto-search" class = "" title = "Search" > < / div >
2023-02-18 19:54:21 +01:00
< / div >
< / div >
< div class = "sidebar-menu-container" >
< ul class = "list-unstyled mt-1" >
< li class = "sidebar-item" >
< div class = "sidebar-item-container" >
< a href = "./index.html" class = "sidebar-item-text sidebar-link" > Preface< / a >
< / div >
< / li >
2023-02-23 23:41:24 +01:00
< li class = "sidebar-item sidebar-item-section" >
< div class = "sidebar-item-container" >
< a href = "./intro.html" class = "sidebar-item-text sidebar-link" > The OBITools< / a >
< a class = "sidebar-item-toggle text-start" data-bs-toggle = "collapse" data-bs-target = "#quarto-sidebar-section-1" aria-expanded = "true" >
< i class = "bi bi-chevron-right ms-2" > < / i >
< / a >
< / div >
< ul id = "quarto-sidebar-section-1" class = "collapse list-unstyled sidebar-section depth1 show" >
< li class = "sidebar-item" >
2023-02-18 19:54:21 +01:00
< div class = "sidebar-item-container" >
2024-01-04 14:17:44 +01:00
< a href = "./installation.html" class = "sidebar-item-text sidebar-link" > < span class = "chapter-number" > 1< / span > < span class = "chapter-title" > Installation of the < em > OBITools< / em > < / span > < / a >
2023-02-18 19:54:21 +01:00
< / div >
< / li >
2023-02-23 23:41:24 +01:00
< li class = "sidebar-item" >
2023-02-18 19:54:21 +01:00
< div class = "sidebar-item-container" >
2024-01-04 14:17:44 +01:00
< a href = "./formats.html" class = "sidebar-item-text sidebar-link" > < span class = "chapter-number" > 2< / span > < span class = "chapter-title" > File formats usable with < em > OBITools< / em > < / span > < / a >
2023-02-18 19:54:21 +01:00
< / div >
< / li >
2023-02-23 23:41:24 +01:00
< li class = "sidebar-item" >
2023-02-18 19:54:21 +01:00
< div class = "sidebar-item-container" >
2024-01-04 14:17:44 +01:00
< a href = "./tutorial.html" class = "sidebar-item-text sidebar-link" > < span class = "chapter-number" > 3< / span > < span class = "chapter-title" > OBITools V4 Tutorial< / span > < / a >
2023-02-18 19:54:21 +01:00
< / div >
< / li >
2023-02-23 23:41:24 +01:00
< / ul >
< / li >
< li class = "sidebar-item sidebar-item-section" >
< div class = "sidebar-item-container" >
< a href = "./commands.html" class = "sidebar-item-text sidebar-link" > The *OBITools V4* commands< / a >
< a class = "sidebar-item-toggle text-start" data-bs-toggle = "collapse" data-bs-target = "#quarto-sidebar-section-2" aria-expanded = "true" >
< i class = "bi bi-chevron-right ms-2" > < / i >
< / a >
< / div >
< ul id = "quarto-sidebar-section-2" class = "collapse list-unstyled sidebar-section depth1 show" >
< li class = "sidebar-item" >
2023-02-18 19:54:21 +01:00
< div class = "sidebar-item-container" >
2024-01-04 14:17:44 +01:00
< a href = "./inupt.html" class = "sidebar-item-text sidebar-link active" > < span class = "chapter-number" > 4< / span > < span class = "chapter-title" > Specifying the data input to < em > OBITools< / em > commands< / span > < / a >
2023-02-18 19:54:21 +01:00
< / div >
< / li >
2023-02-23 23:41:24 +01:00
< li class = "sidebar-item" >
2023-02-18 19:54:21 +01:00
< div class = "sidebar-item-container" >
2024-01-04 14:17:44 +01:00
< a href = "./output.html" class = "sidebar-item-text sidebar-link" > < span class = "chapter-number" > 5< / span > < span class = "chapter-title" > Controling OBITools outputs< / span > < / a >
2023-02-18 19:54:21 +01:00
< / div >
< / li >
2023-02-23 23:41:24 +01:00
< li class = "sidebar-item" >
2023-02-18 19:54:21 +01:00
< div class = "sidebar-item-container" >
2024-01-04 14:17:44 +01:00
< a href = "./common_options.html" class = "sidebar-item-text sidebar-link" > < span class = "chapter-number" > 6< / span > < span class = "chapter-title" > Options common to most of the < em > OBITools< / em > commands< / span > < / a >
2023-02-18 19:54:21 +01:00
< / div >
< / li >
2023-02-23 23:41:24 +01:00
< li class = "sidebar-item" >
2023-02-18 19:54:21 +01:00
< div class = "sidebar-item-container" >
2024-01-04 14:17:44 +01:00
< a href = "./expressions.html" class = "sidebar-item-text sidebar-link" > < span class = "chapter-number" > 7< / span > < span class = "chapter-title" > OBITools expression language< / span > < / a >
2023-02-18 19:54:21 +01:00
< / div >
< / li >
2023-02-23 23:41:24 +01:00
< li class = "sidebar-item" >
< div class = "sidebar-item-container" >
2024-01-04 14:17:44 +01:00
< a href = "./comm_metabarcode_design.html" class = "sidebar-item-text sidebar-link" > < span class = "chapter-number" > 8< / span > < span class = "chapter-title" > Metabarcode design and quality assessment< / span > < / a >
2023-02-23 23:41:24 +01:00
< / div >
< / li >
< li class = "sidebar-item" >
< div class = "sidebar-item-container" >
2024-01-04 14:17:44 +01:00
< a href = "./comm_reformat.html" class = "sidebar-item-text sidebar-link" > < span class = "chapter-number" > 9< / span > < span class = "chapter-title" > File format conversions< / span > < / a >
2023-02-23 23:41:24 +01:00
< / div >
< / li >
< li class = "sidebar-item" >
< div class = "sidebar-item-container" >
2024-01-04 14:17:44 +01:00
< a href = "./comm_annotation.html" class = "sidebar-item-text sidebar-link" > < span class = "chapter-number" > 10< / span > < span class = "chapter-title" > Sequence annotations< / span > < / a >
2023-02-23 23:41:24 +01:00
< / div >
< / li >
< li class = "sidebar-item" >
< div class = "sidebar-item-container" >
2024-01-04 14:17:44 +01:00
< a href = "./comm_computation.html" class = "sidebar-item-text sidebar-link" > < span class = "chapter-number" > 11< / span > < span class = "chapter-title" > Computations on sequences< / span > < / a >
2023-02-23 23:41:24 +01:00
< / div >
< / li >
< li class = "sidebar-item" >
< div class = "sidebar-item-container" >
2024-01-04 14:17:44 +01:00
< a href = "./comm_sampling.html" class = "sidebar-item-text sidebar-link" > < span class = "chapter-number" > 12< / span > < span class = "chapter-title" > Sequence sampling and filtering< / span > < / a >
2023-02-23 23:41:24 +01:00
< / div >
< / li >
< li class = "sidebar-item" >
< div class = "sidebar-item-container" >
2024-01-04 14:17:44 +01:00
< a href = "./comm_utilities.html" class = "sidebar-item-text sidebar-link" > < span class = "chapter-number" > 13< / span > < span class = "chapter-title" > Utilities< / span > < / a >
2023-02-23 23:41:24 +01:00
< / div >
< / li >
< / ul >
< / li >
< li class = "sidebar-item sidebar-item-section" >
< span class = "sidebar-item-text sidebar-link text-start" > The GO *OBITools* library< / span >
< / li >
< li class = "sidebar-item sidebar-item-section" >
< div class = "sidebar-item-container" >
< a class = "sidebar-item-text sidebar-link text-start" data-bs-toggle = "collapse" data-bs-target = "#quarto-sidebar-section-4" aria-expanded = "true" > Appendices< / a >
< a class = "sidebar-item-toggle text-start" data-bs-toggle = "collapse" data-bs-target = "#quarto-sidebar-section-4" aria-expanded = "true" >
< i class = "bi bi-chevron-right ms-2" > < / i >
< / a >
< / div >
< ul id = "quarto-sidebar-section-4" class = "collapse list-unstyled sidebar-section depth1 show" >
< li class = "sidebar-item" >
< div class = "sidebar-item-container" >
2024-01-04 14:17:44 +01:00
< a href = "./annexes.html" class = "sidebar-item-text sidebar-link" > < span class = "chapter-number" > A< / span > < span class = "chapter-title" > Annexes< / span > < / a >
2023-02-23 23:41:24 +01:00
< / div >
< / li >
< li class = "sidebar-item" >
2023-02-18 19:54:21 +01:00
< div class = "sidebar-item-container" >
< a href = "./references.html" class = "sidebar-item-text sidebar-link" > References< / a >
< / div >
< / li >
2023-02-23 23:41:24 +01:00
< / ul >
< / li >
2023-02-18 19:54:21 +01:00
< / ul >
< / div >
< / nav >
<!-- margin - sidebar -->
< div id = "quarto-margin-sidebar" class = "sidebar margin-sidebar" >
2023-02-23 23:41:24 +01:00
< nav id = "TOC" role = "doc-toc" class = "toc-active" >
< h2 id = "toc-title" > Table of contents< / h2 >
< ul >
< li > < a href = "#specifying-input-format" id = "toc-specifying-input-format" class = "nav-link active" data-scroll-target = "#specifying-input-format" > < span class = "toc-section-number" > 4.1< / span > Specifying input format< / a > < / li >
< / ul >
< / nav >
2023-02-18 19:54:21 +01:00
< / div >
<!-- main -->
< main class = "content" id = "quarto-document-content" >
< header id = "title-block-header" class = "quarto-title-block default" >
< div class = "quarto-title" >
2024-01-04 14:17:44 +01:00
< h1 class = "title d-none d-lg-block" > < span class = "chapter-number" > 4< / span > < span class = "chapter-title" > Specifying the data input to < em > OBITools< / em > commands< / span > < / h1 >
2023-02-18 19:54:21 +01:00
< / div >
< div class = "quarto-title-meta" >
< / div >
< / header >
2023-02-23 23:41:24 +01:00
< section id = "specifying-input-format" class = "level2" data-number = "4.1" >
< h2 data-number = "4.1" class = "anchored" data-anchor-id = "specifying-input-format" > < span class = "header-section-number" > 4.1< / span > Specifying input format< / h2 >
2024-01-04 14:17:44 +01:00
< p > Five sequence formats are accepted for input files. < em > Fasta< / em > (< a href = "formats.html#sec-fasta" > < span > Section 2.1.2< / span > < / a > ) and < em > Fastq< / em > (< a href = "formats.html#sec-fastq" > < span > Section 2.1.3< / span > < / a > ) 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 < em > OBITools< / em > and allows to read < em > ecoPCR< / em > outputs as sequence files.< / p >
2023-02-23 23:41:24 +01:00
< ul >
< li > < code > --ecopcr< / code > : Read data following the < em > ecoPCR< / em > output format.< / li >
< li > < code > --embl< / code > Read data following the < em > EMBL< / em > flatfile format.< / li >
< li > < code > --genbank< / code > Read data following the < em > Genbank< / em > flatfile format.< / li >
< / ul >
< p > Several encoding schemes have been proposed for quality scores in < em > Fastq< / em > format. Currently, < em > OBITools< / em > considers Sanger encoding as the standard. For reasons of compatibility with older datasets produced with < em > Solexa< / em > sequencers, it is possible, by using the following option, to force the use of the corresponding quality encoding scheme when reading these older files.< / p >
< ul >
< li > < code > --solexa< / code > Decodes quality string according to the Solexa specification. (default: false)< / li >
< / ul >
2023-02-18 19:54:21 +01:00
< / section >
< / main > <!-- /main -->
< script id = "quarto-html-after-body" type = "application/javascript" >
window . document . addEventListener ( "DOMContentLoaded" , function ( event ) {
const toggleBodyColorMode = ( bsSheetEl ) => {
const mode = bsSheetEl . getAttribute ( "data-mode" ) ;
const bodyEl = window . document . querySelector ( "body" ) ;
if ( mode === "dark" ) {
bodyEl . classList . add ( "quarto-dark" ) ;
bodyEl . classList . remove ( "quarto-light" ) ;
} else {
bodyEl . classList . add ( "quarto-light" ) ;
bodyEl . classList . remove ( "quarto-dark" ) ;
}
}
const toggleBodyColorPrimary = ( ) => {
const bsSheetEl = window . document . querySelector ( "link#quarto-bootstrap" ) ;
if ( bsSheetEl ) {
toggleBodyColorMode ( bsSheetEl ) ;
}
}
toggleBodyColorPrimary ( ) ;
const icon = "" ;
const anchorJS = new window . AnchorJS ( ) ;
anchorJS . options = {
placement : 'right' ,
icon : icon
} ;
anchorJS . add ( '.anchored' ) ;
const clipboard = new window . ClipboardJS ( '.code-copy-button' , {
target : function ( trigger ) {
return trigger . previousElementSibling ;
}
} ) ;
clipboard . on ( 'success' , function ( e ) {
// button target
const button = e . trigger ;
// don't keep focus
button . blur ( ) ;
// flash "checked"
button . classList . add ( 'code-copy-button-checked' ) ;
var currentTitle = button . getAttribute ( "title" ) ;
button . setAttribute ( "title" , "Copied!" ) ;
let tooltip ;
if ( window . bootstrap ) {
button . setAttribute ( "data-bs-toggle" , "tooltip" ) ;
button . setAttribute ( "data-bs-placement" , "left" ) ;
button . setAttribute ( "data-bs-title" , "Copied!" ) ;
tooltip = new bootstrap . Tooltip ( button ,
{ trigger : "manual" ,
customClass : "code-copy-button-tooltip" ,
offset : [ 0 , - 8 ] } ) ;
tooltip . show ( ) ;
}
setTimeout ( function ( ) {
if ( tooltip ) {
tooltip . hide ( ) ;
button . removeAttribute ( "data-bs-title" ) ;
button . removeAttribute ( "data-bs-toggle" ) ;
button . removeAttribute ( "data-bs-placement" ) ;
}
button . setAttribute ( "title" , currentTitle ) ;
button . classList . remove ( 'code-copy-button-checked' ) ;
} , 1000 ) ;
// clear code selection
e . clearSelection ( ) ;
} ) ;
function tippyHover ( el , contentFn ) {
const config = {
allowHTML : true ,
content : contentFn ,
maxWidth : 500 ,
delay : 100 ,
arrow : false ,
appendTo : function ( el ) {
return el . parentElement ;
} ,
interactive : true ,
interactiveBorder : 10 ,
theme : 'quarto' ,
placement : 'bottom-start'
} ;
window . tippy ( el , config ) ;
}
const noterefs = window . document . querySelectorAll ( 'a[role="doc-noteref"]' ) ;
for ( var i = 0 ; i < noterefs . length ; i ++ ) {
const ref = noterefs [ i ] ;
tippyHover ( ref , function ( ) {
// use id or data attribute instead here
let href = ref . getAttribute ( 'data-footnote-href' ) || ref . getAttribute ( 'href' ) ;
try { href = new URL ( href ) . hash ; } catch { }
const id = href . replace ( /^#\/?/ , "" ) ;
const note = window . document . getElementById ( id ) ;
return note . innerHTML ;
} ) ;
}
const findCites = ( el ) => {
const parentEl = el . parentElement ;
if ( parentEl ) {
const cites = parentEl . dataset . cites ;
if ( cites ) {
return {
el ,
cites : cites . split ( ' ' )
} ;
} else {
return findCites ( el . parentElement )
}
} else {
return undefined ;
}
} ;
var bibliorefs = window . document . querySelectorAll ( 'a[role="doc-biblioref"]' ) ;
for ( var i = 0 ; i < bibliorefs . length ; i ++ ) {
const ref = bibliorefs [ i ] ;
const citeInfo = findCites ( ref ) ;
if ( citeInfo ) {
tippyHover ( citeInfo . el , function ( ) {
var popup = window . document . createElement ( 'div' ) ;
citeInfo . cites . forEach ( function ( cite ) {
var citeDiv = window . document . createElement ( 'div' ) ;
citeDiv . classList . add ( 'hanging-indent' ) ;
citeDiv . classList . add ( 'csl-entry' ) ;
var biblioDiv = window . document . getElementById ( 'ref-' + cite ) ;
if ( biblioDiv ) {
citeDiv . innerHTML = biblioDiv . innerHTML ;
}
popup . appendChild ( citeDiv ) ;
} ) ;
return popup . innerHTML ;
} ) ;
}
}
} ) ;
< / script >
< nav class = "page-navigation" >
< div class = "nav-page nav-page-previous" >
< a href = "./commands.html" class = "pagination-link" >
2023-02-23 23:41:24 +01:00
< i class = "bi bi-arrow-left-short" > < / i > < span class = "nav-page-text" > The < em > OBITools V4< / em > commands< / span >
2023-02-18 19:54:21 +01:00
< / a >
< / div >
< div class = "nav-page nav-page-next" >
2023-02-23 23:41:24 +01:00
< a href = "./output.html" class = "pagination-link" >
2024-01-04 14:17:44 +01:00
< span class = "nav-page-text" > < span class = "chapter-number" > 5< / span > < span class = "chapter-title" > Controling OBITools outputs< / span > < / span > < i class = "bi bi-arrow-right-short" > < / i >
2023-02-18 19:54:21 +01:00
< / a >
< / div >
< / nav >
< / div > <!-- /content -->
< / body > < / html >