CINXE.COM
galah
<!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.3.290"> <meta name="viewport" content="width=device-width, initial-scale=1.0, user-scalable=yes"> <title>galah</title> <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 -1em; /* quarto-specific, see https://github.com/quarto-dev/quarto-cli/issues/4556 */ vertical-align: middle; } /* CSS for syntax highlighting */ pre > code.sourceCode { white-space: pre; position: relative; } pre > code.sourceCode > span { display: inline-block; line-height: 1.25; } pre > code.sourceCode > span:empty { height: 1.2em; } .sourceCode { overflow: visible; } code.sourceCode > span { color: inherit; text-decoration: inherit; } div.sourceCode { margin: 1em 0; } pre.sourceCode { margin: 0; } @media screen { div.sourceCode { overflow: auto; } } @media print { pre > code.sourceCode { white-space: pre-wrap; } pre > code.sourceCode > span { text-indent: -5em; padding-left: 5em; } } pre.numberSource code { counter-reset: source-line 0; } pre.numberSource code > span { position: relative; left: -4em; counter-increment: source-line; } pre.numberSource code > span > a:first-child::before { content: counter(source-line); position: relative; left: -1em; text-align: right; vertical-align: baseline; border: none; display: inline-block; -webkit-touch-callout: none; -webkit-user-select: none; -khtml-user-select: none; -moz-user-select: none; -ms-user-select: none; user-select: none; padding: 0 4px; width: 4em; } pre.numberSource { margin-left: 3em; padding-left: 4px; } div.sourceCode { } @media screen { pre > code.sourceCode > span > a:first-child::before { text-decoration: underline; } } </style> <script src="site_libs/quarto-nav/quarto-nav.js"></script> <script src="site_libs/quarto-nav/headroom.min.js"></script> <link href="./images/favicon_galah.ico" rel="icon"> <script src="site_libs/clipboard/clipboard.min.js"></script> <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">{ "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> <link rel="stylesheet" href="styles.css"> <meta property="og:title" content=""> <meta property="og:image" content="https://raw.githubusercontent.com/AtlasOfLivingAustralia/ala-labs/main/images/hex/galah_logo.png"> <meta property="og:site-name" content="galah"> <meta name="twitter:title" content=""> <meta name="twitter:image" content="https://raw.githubusercontent.com/AtlasOfLivingAustralia/ala-labs/main/images/hex/galah_logo.png"> <meta name="twitter:card" content="summary_large_image"> </head> <body class="nav-fixed"> <div id="quarto-search-results"></div> <header id="quarto-header" class="headroom fixed-top"> <nav class="navbar navbar-expand-lg navbar-dark "> <div class="navbar-container container-fluid"> <div class="navbar-brand-container"> <a class="navbar-brand" href="./index.html"> <span class="navbar-title">galah</span> </a> </div> <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbarCollapse" aria-controls="navbarCollapse" aria-expanded="false" aria-label="Toggle navigation" onclick="if (window.quartoToggleHeadroom) { window.quartoToggleHeadroom(); }"> <span class="navbar-toggler-icon"></span> </button> <div class="collapse navbar-collapse" id="navbarCollapse"> <ul class="navbar-nav navbar-nav-scroll ms-auto"> <li class="nav-item"> <a class="nav-link" href="http://galah.ala.org.au/R" rel="" target=""> <span class="menu-text">R package</span></a> </li> <li class="nav-item"> <a class="nav-link" href="https://galah.ala.org.au/Python" rel="" target=""> <span class="menu-text">Python package</span></a> </li> <li class="nav-item compact"> <a class="nav-link" href="https://www.ala.org.au" rel="" target=""><i class="bi bi-ala" role="img"> </i> <span class="menu-text"></span></a> </li> </ul> <div class="quarto-navbar-tools"> </div> </div> <!-- /navcollapse --> </div> <!-- /container-fluid --> </nav> </header> <!-- content --> <div id="quarto-content" class="quarto-container page-columns page-rows-contents page-layout-full page-navbar"> <!-- sidebar --> <!-- margin-sidebar --> <!-- main --> <main class="content page-columns page-full column-body" id="quarto-document-content"> <div class="column-screen page-columns page-full" style="background-color: #FFFFFF; padding-top: 50px; margin-top: -4vh"> <div class="column-page quarto-layout-panel" style="float:left; background-color: #FFFFFF;"> <div class="quarto-layout-row quarto-layout-valign-top"> <div class="cell quarto-layout-cell" style="flex-basis: 50.0%;justify-content: center;"> <div class="cell-output-display"> <div class="quarto-figure quarto-figure-center" style=""> <figure class="figure"> <p><img src="https://raw.githubusercontent.com/AtlasOfLivingAustralia/ala-labs/main/images/hex/galah_logo.png" class="quarto-discovered-preview-image img-fluid figure-img" width="400"></p> </figure> </div> </div> </div> <section id="galah" class="level1 quarto-layout-cell" style="flex-basis: 50.0%;justify-content: center;"> <h1>galah</h1> <p>galah is an interface to biodiversity data hosted by the <a href="https://ala.org.au/">Atlas of Living Australia (ALA)</a>. It enables users to locate and download species occurrence records (observations, specimens, eDNA records, etc.), taxonomic information, or associated media such as images or sounds, and to restrict their queries to particular taxa or locations.<br><br> If you have any questions, comments, or spot any bugs, <a href="mailto:support@ala.org.au">email us</a> or <a href="https://github.com/AtlasOfLivingAustralia/galah">report an issue</a> on our GitHub page</p> </section> </div> </div> </div> <div class="column-screen page-columns page-full"> <div class="column-page" style="padding-top: 30px;"> <div class="grid"> <div class="g-col-lg-6 g-col-12"> <div class="cell"> <div class="cell-output-display"> <div class="button-column"> <a href="http://galah.ala.org.au/R" style="border-bottom: none"> <button class="button-web">R</button> </a> </div> </div> </div> <div class="sourceCode" id="cb1"><pre class="sourceCode markdown code-with-copy"><code class="sourceCode markdown"><span id="cb1-1"><a href="#cb1-1" aria-hidden="true" tabindex="-1"></a><span class="in">```{r}</span></span> <span id="cb1-2"><a href="#cb1-2" aria-hidden="true" tabindex="-1"></a><span class="fu">library</span>(galah)</span> <span id="cb1-3"><a href="#cb1-3" aria-hidden="true" tabindex="-1"></a></span> <span id="cb1-4"><a href="#cb1-4" aria-hidden="true" tabindex="-1"></a><span class="fu">galah_call</span>() <span class="sc">|></span></span> <span id="cb1-5"><a href="#cb1-5" aria-hidden="true" tabindex="-1"></a> <span class="fu">identify</span>(<span class="st">"reptilia"</span>, <span class="st">"mammalia"</span>) <span class="sc">|></span></span> <span id="cb1-6"><a href="#cb1-6" aria-hidden="true" tabindex="-1"></a> <span class="fu">filter</span>(year <span class="sc">></span> <span class="dv">2019</span>) <span class="sc">|></span></span> <span id="cb1-7"><a href="#cb1-7" aria-hidden="true" tabindex="-1"></a> <span class="fu">group_by</span>(order) <span class="sc">|></span></span> <span id="cb1-8"><a href="#cb1-8" aria-hidden="true" tabindex="-1"></a> <span class="fu">atlas_counts</span>()</span> <span id="cb1-9"><a href="#cb1-9" aria-hidden="true" tabindex="-1"></a><span class="in">```</span></span></code><button title="Copy to Clipboard" class="code-copy-button"><i class="bi"></i></button></pre></div> <div class="cell"> <div class="cell-output cell-output-stdout"> <pre><code># A tibble: 18 × 2 order count <chr> <int> 1 Diprotodontia 209587 2 Squamata 100601 3 Peramelemorphia 63989 4 Rodentia 49891 5 Chiroptera 35437 6 Carnivora 28522 7 Lagomorpha 22020 8 Artiodactyla 18268 9 Monotremata 18072 10 Dasyuromorphia 17703 11 Testudines 11402 12 Crocodylia 8456 13 Cetacea 3748 14 Perissodactyla 819 15 Sirenia 51 16 Insectivora 13 17 Primates 1 18 Rhynchocephalia 1</code></pre> </div> </div> </div> <div class="g-col-lg-6 g-col-12"> <div class="cell"> <div class="cell-output-display"> <div class="button-column"> <a href="http://galah.ala.org.au/Python" style="border-bottom: none"> <button class="button-web">Python</button> </a> </div> </div> </div> <div class="sourceCode" id="cb3"><pre class="sourceCode markdown code-with-copy"><code class="sourceCode markdown"><span id="cb3-1"><a href="#cb3-1" aria-hidden="true" tabindex="-1"></a><span class="in">```{python}</span></span> <span id="cb3-2"><a href="#cb3-2" aria-hidden="true" tabindex="-1"></a><span class="im">import</span> galah</span> <span id="cb3-3"><a href="#cb3-3" aria-hidden="true" tabindex="-1"></a></span> <span id="cb3-4"><a href="#cb3-4" aria-hidden="true" tabindex="-1"></a>galah.atlas_counts(</span> <span id="cb3-5"><a href="#cb3-5" aria-hidden="true" tabindex="-1"></a> taxa <span class="op">=</span> [<span class="st">"reptilia"</span>,<span class="st">"mammalia"</span>],</span> <span id="cb3-6"><a href="#cb3-6" aria-hidden="true" tabindex="-1"></a> filters <span class="op">=</span> <span class="st">"year>2019"</span>,</span> <span id="cb3-7"><a href="#cb3-7" aria-hidden="true" tabindex="-1"></a> group_by <span class="op">=</span> <span class="st">"order"</span></span> <span id="cb3-8"><a href="#cb3-8" aria-hidden="true" tabindex="-1"></a>)</span> <span id="cb3-9"><a href="#cb3-9" aria-hidden="true" tabindex="-1"></a><span class="in">```</span></span></code><button title="Copy to Clipboard" class="code-copy-button"><i class="bi"></i></button></pre></div> <div class="cell"> <div class="cell-output cell-output-stdout"> <pre><code> order count 0 Artiodactyla 18268 1 Carnivora 28522 2 Cetacea 3748 3 Chiroptera 35437 4 Crocodylia 8456 5 Dasyuromorphia 17703 6 Diprotodontia 209587 7 Insectivora 13 8 Lagomorpha 22020 9 Monotremata 18072 10 Peramelemorphia 63989 11 Perissodactyla 819 12 Primates 1 13 Rhynchocephalia 1 14 Rodentia 49891 15 Sirenia 51 16 Squamata 100601 17 Testudines 11402</code></pre> </div> </div> </div> </div> </div> </div> </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 isCodeAnnotation = (el) => { for (const clz of el.classList) { if (clz.startsWith('code-annotation-')) { return true; } } return false; } const clipboard = new window.ClipboardJS('.code-copy-button', { text: function(trigger) { const codeEl = trigger.previousElementSibling.cloneNode(true); for (const childEl of codeEl.children) { if (isCodeAnnotation(childEl)) { childEl.remove(); } } return codeEl.innerText; } }); 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; }); } let selectedAnnoteEl; const selectorForAnnotation = ( cell, annotation) => { let cellAttr = 'data-code-cell="' + cell + '"'; let lineAttr = 'data-code-annotation="' + annotation + '"'; const selector = 'span[' + cellAttr + '][' + lineAttr + ']'; return selector; } const selectCodeLines = (annoteEl) => { const doc = window.document; const targetCell = annoteEl.getAttribute("data-target-cell"); const targetAnnotation = annoteEl.getAttribute("data-target-annotation"); const annoteSpan = window.document.querySelector(selectorForAnnotation(targetCell, targetAnnotation)); const lines = annoteSpan.getAttribute("data-code-lines").split(","); const lineIds = lines.map((line) => { return targetCell + "-" + line; }) let top = null; let height = null; let parent = null; if (lineIds.length > 0) { //compute the position of the single el (top and bottom and make a div) const el = window.document.getElementById(lineIds[0]); top = el.offsetTop; height = el.offsetHeight; parent = el.parentElement.parentElement; if (lineIds.length > 1) { const lastEl = window.document.getElementById(lineIds[lineIds.length - 1]); const bottom = lastEl.offsetTop + lastEl.offsetHeight; height = bottom - top; } if (top !== null && height !== null && parent !== null) { // cook up a div (if necessary) and position it let div = window.document.getElementById("code-annotation-line-highlight"); if (div === null) { div = window.document.createElement("div"); div.setAttribute("id", "code-annotation-line-highlight"); div.style.position = 'absolute'; parent.appendChild(div); } div.style.top = top - 2 + "px"; div.style.height = height + 4 + "px"; let gutterDiv = window.document.getElementById("code-annotation-line-highlight-gutter"); if (gutterDiv === null) { gutterDiv = window.document.createElement("div"); gutterDiv.setAttribute("id", "code-annotation-line-highlight-gutter"); gutterDiv.style.position = 'absolute'; const codeCell = window.document.getElementById(targetCell); const gutter = codeCell.querySelector('.code-annotation-gutter'); gutter.appendChild(gutterDiv); } gutterDiv.style.top = top - 2 + "px"; gutterDiv.style.height = height + 4 + "px"; } selectedAnnoteEl = annoteEl; } }; const unselectCodeLines = () => { const elementsIds = ["code-annotation-line-highlight", "code-annotation-line-highlight-gutter"]; elementsIds.forEach((elId) => { const div = window.document.getElementById(elId); if (div) { div.remove(); } }); selectedAnnoteEl = undefined; }; // Attach click handler to the DT const annoteDls = window.document.querySelectorAll('dt[data-target-cell]'); for (const annoteDlNode of annoteDls) { annoteDlNode.addEventListener('click', (event) => { const clickedEl = event.target; if (clickedEl !== selectedAnnoteEl) { unselectCodeLines(); const activeEl = window.document.querySelector('dt[data-target-cell].code-annotation-active'); if (activeEl) { activeEl.classList.remove('code-annotation-active'); } selectCodeLines(clickedEl); clickedEl.classList.add('code-annotation-active'); } else { // Unselect the line unselectCodeLines(); clickedEl.classList.remove('code-annotation-active'); } }); } 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> </div> <!-- /content --> <footer class="footer"> <div class="nav-footer"> <div class="nav-footer-left"><a href="https://ala.org.au/"><img src="images/ALA_Logo.jpg" class="img-fluid" alt="Atlas of Living Australia" width="200"></a></div> <div class="nav-footer-center"> <ul class="footer-items list-unstyled"> <li class="nav-item"> <a class="nav-link" href="https://www.ala.org.au/terms-of-use/#cy">Copyright</a> </li> <li class="nav-item"> <a class="nav-link" href="https://creativecommons.org/licenses/by/3.0/au/">License</a> </li> <li class="nav-item"> <a class="nav-link" href="https://www.ala.org.au/terms-of-use/">Terms of Use</a> </li> <li class="nav-item"> <a class="nav-link" href="https://ala.org.au/contact-us/">Support</a> </li> </ul> </div> <div class="nav-footer-right"> <ul class="footer-items list-unstyled"> <li class="nav-item compact"> <a class="nav-link" href="https://twitter.com/atlaslivingaust"> <i class="bi bi-twitter" role="img"> </i> </a> </li> </ul> </div> </div> </footer> </body></html>