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" >
2023-02-23 23:41:24 +01:00
< title > OBITools V4 - 1 Installation of the obitools< / 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(4vw, 1.5em);}
div.column{flex: auto; overflow-x: auto;}
div.hanging-indent{margin-left: 1.5em; text-indent: -1.5em;}
ul.task-list{list-style: none;}
ul.task-list li input[type="checkbox"] {
width: 0.8em;
margin: 0 0.8em 0.2em -1.6em;
vertical-align: middle;
}
< / style >
< 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 >
< meta name = "quarto:offset" content = "./" >
2023-02-23 23:41:24 +01:00
< link href = "./formats.html" rel = "next" >
< link href = "./intro.html" rel = "prev" >
2023-02-18 19:54:21 +01:00
< 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" >
< 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 >
2023-02-23 23:41:24 +01:00
< script src = "https://cdn.jsdelivr.net/npm/mathjax@3/es5/tex-chtml-full.js" type = "text/javascript" > < / script >
2023-02-18 19:54:21 +01:00
< / 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" >
2023-02-23 23:41:24 +01:00
< h1 class = "quarto-secondary-nav-title" > < span class = "chapter-number" > 1< / span > < span class = "chapter-title" > Installation of the obitools< / 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" >
< div id = "quarto-search" class = "" title = "Search" > < / div >
< / 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" >
2023-02-23 23:41:24 +01:00
< a href = "./installation.html" class = "sidebar-item-text sidebar-link active" > < span class = "chapter-number" > 1< / span > < span class = "chapter-title" > Installation of the obitools< / 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" >
< 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 >
< / 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" >
< 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 >
< / 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" >
2023-02-23 23:41:24 +01:00
< a href = "./inupt.html" class = "sidebar-item-text sidebar-link" > < 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" >
2023-02-23 23:41:24 +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" >
2023-02-23 23:41:24 +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" >
2023-02-23 23:41:24 +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" >
< 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 >
< / div >
< / li >
< li class = "sidebar-item" >
< div class = "sidebar-item-container" >
< 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 >
< / div >
< / li >
< li class = "sidebar-item" >
< div class = "sidebar-item-container" >
< 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 >
< / div >
< / li >
< li class = "sidebar-item" >
< div class = "sidebar-item-container" >
< 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 >
< / div >
< / li >
< li class = "sidebar-item" >
< div class = "sidebar-item-container" >
< 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 >
< / div >
< / li >
< li class = "sidebar-item" >
< div class = "sidebar-item-container" >
< a href = "./comm_utilities.html" class = "sidebar-item-text sidebar-link" > < span class = "chapter-number" > 13< / span > < span class = "chapter-title" > Utilities< / span > < / a >
< / 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" >
< a href = "./annexes.html" class = "sidebar-item-text sidebar-link" > < span class = "chapter-number" > A< / span > < span class = "chapter-title" > Annexes< / span > < / a >
< / 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 = "#availability-of-the-obitools" id = "toc-availability-of-the-obitools" class = "nav-link active" data-scroll-target = "#availability-of-the-obitools" > < span class = "toc-section-number" > 1.1< / span > Availability of the OBITools< / a > < / li >
< li > < a href = "#prerequisites" id = "toc-prerequisites" class = "nav-link" data-scroll-target = "#prerequisites" > < span class = "toc-section-number" > 1.2< / span > Prerequisites< / a > < / li >
< li > < a href = "#installation-with-the-install-script" id = "toc-installation-with-the-install-script" class = "nav-link" data-scroll-target = "#installation-with-the-install-script" > < span class = "toc-section-number" > 1.3< / span > Installation with the install script< / a > < / li >
< li > < a href = "#compilation-from-sources" id = "toc-compilation-from-sources" class = "nav-link" data-scroll-target = "#compilation-from-sources" > < span class = "toc-section-number" > 1.4< / span > Compilation from sources< / 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" >
2023-02-23 23:41:24 +01:00
< h1 class = "title d-none d-lg-block" > < span class = "chapter-number" > 1< / span > < span class = "chapter-title" > Installation of the obitools< / 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 = "availability-of-the-obitools" class = "level2" data-number = "1.1" >
< h2 data-number = "1.1" class = "anchored" data-anchor-id = "availability-of-the-obitools" > < span class = "header-section-number" > 1.1< / span > Availability of the OBITools< / h2 >
< p > The < em > OBITools< / em > are open source and protected by the < a href = "http://www.cecill.info/licences/Licence_CeCILL_V2.1-en.html" > CeCILL 2.1 license< / a > .< / p >
< p > All the sources of the < a href = "http://metabarcoding.org/obitools4" > < em > OBITools4< / em > < / a > can be downloaded from the metabarcoding git server (https://git.metabarcoding.org).< / p >
< / section >
< section id = "prerequisites" class = "level2" data-number = "1.2" >
< h2 data-number = "1.2" class = "anchored" data-anchor-id = "prerequisites" > < span class = "header-section-number" > 1.2< / span > Prerequisites< / h2 >
< p > The < em > OBITools4< / em > are developped using the < a href = "https://go.dev/" > GO programming language< / a > , we stick to the latest version of the language, today the < span class = "math inline" > \(1.19.5\)< / span > . If you want to download and compile the sources yourself, you first need to install the corresponding compiler on your system. Some parts of the soft are also written in C, therefore a recent C compiler is also requested, GCC on Linux or Windows, the Developer Tools on Mac.< / p >
< p > Whatever the installation you decide for, you will have to ensure that a C compiler is available on your system.< / p >
2023-02-18 19:54:21 +01:00
< / section >
2023-02-23 23:41:24 +01:00
< section id = "installation-with-the-install-script" class = "level2" data-number = "1.3" >
< h2 data-number = "1.3" class = "anchored" data-anchor-id = "installation-with-the-install-script" > < span class = "header-section-number" > 1.3< / span > Installation with the install script< / h2 >
2023-02-18 19:54:21 +01:00
< / section >
2023-02-23 23:41:24 +01:00
< section id = "compilation-from-sources" class = "level2" data-number = "1.4" >
< h2 data-number = "1.4" class = "anchored" data-anchor-id = "compilation-from-sources" > < span class = "header-section-number" > 1.4< / span > Compilation from sources< / h2 >
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" >
2023-02-23 23:41:24 +01:00
< a href = "./intro.html" class = "pagination-link" >
< i class = "bi bi-arrow-left-short" > < / i > < span class = "nav-page-text" > The OBITools< / 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 = "./formats.html" class = "pagination-link" >
< span class = "nav-page-text" > < span class = "chapter-number" > 2< / span > < span class = "chapter-title" > File formats usable with < em > OBITools< / em > < / 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 >
