Skip to content

Latest commit

 

History

History
209 lines (160 loc) · 9.09 KB

SSBworkshop.md

File metadata and controls

209 lines (160 loc) · 9.09 KB
title layout venue address country language humandate humantime instructor email collaborative_notes eventbrite permalink
Open Tree SSB2020
workshop
Using the Open Tree of Life for your Research, SSB 2020
Hotel Indigo
us
en
Jan 3, 2020
1:30 pm - 5 pm
Emily Jane McTavish
Mark Holder
Luna Luisa Sanchez Reyes
ejmctavish@ucmerced.edu
/SSBworkshop/

We have borrowed the Carpentries website template and installation instructions. This is not a Carpentries workshop (although we highly recommend them!). Learn more about the carpentries at https://carpentries.org/

Using the Open Tree of Life for your Research

The Open Tree of Life project is a phylogenetic resource that offers a synthetic tree summarizing evolutionary relationships across 2.6 million taxa. OpenTree (as of September 2019) also provides access to 4,168 published studies comprising 9,367 trees, and the database is growing weekly. The tips of these trees are mapped to taxonomic identifiers that link across taxonomic and informatics databases such as NCBI and The Global Biodiversity Information Facility (GBIF). The website also provides user-friendly resources for bulk reconciliation of taxonomic names to these standardized identifiers. Together these resources offer a formidable suite of tools and data for taxonomic name reconciliation and phylogenetic comparisons and analyses. This workshop will cover how to understand, access and apply these data resources from the Open Tree of Life project to your research questions. Topics will include accessing phylogenetic relationships for arbitrary sets of taxa, applying date estimates to these trees, linking phylogenetic and geographic information, assessing conflict between phylogenetic estimates, and incorporating your own phylogenetic estimates into the OpenTree of Life project. The workshop will include interactive browser based exercises, demonstrations of how to access OpenTree data through the API, and tutorials in R and Python. Experience using a command line interface, R or Python will be helpful, but is not required.

{% comment %} SPECIAL REQUIREMENTS

Modify the block below if there are any special requirements. {% endcomment %}

Requirements:

  • Participants must bring a laptop with a Mac, Linux, or Windows operating system (not a tablet, Chromebook, etc.) that they have administrative privileges on. They should have a few specific software packages installed (listed below). Run the Installation checks to make sure everything is working in advance of the workshop
  • Bring a recently published tree of interest to you if you can access one (newick or nexus format)
  • Create a Github account if you don't have one. Github.

{% comment %} ACCESSIBILITY

Modify the block below if there are any barriers to accessibility or special instructions. {% endcomment %}

Accessibility: We are committed to making this workshop accessible to everybody. The workshop organizers have checked that:

  • The room is wheelchair / scooter accessible.
  • Accessible restrooms are available.

Materials will be provided in advance of the workshop and large-print handouts are available if needed by notifying the organizers in advance. If we can help making learning easier for you (e.g. sign-language interpreters, lactation facilities) please get in touch (using contact details below) and we will attempt to provide them.

{% comment %} CONTACT EMAIL ADDRESS

Display the contact email address set in the configuration file. {% endcomment %}

Contact: Please email {% if page.email %} {% for email in page.email %} {% if forloop.last and page.email.size > 1 %} or {% else %} {% unless forloop.first %} , {% endunless %} {% endif %} {{email}} {% endfor %} {% else %} to-be-announced {% endif %} for more information.


{% comment%} CODE OF CONDUCT {% endcomment %}

Code of Conduct

Everyone who participates in SSB2020 is required to conform to the Code of Conduct.

Collaborative Notes Document

We will use this collaborative document for chatting, taking notes, and sharing URLs and bits of code. Please sign in!


Draft Schedule (subject to change based on interest)

12:00 Lunch
12:30 Intro to OpenTree
12:50 Supertree synthesis
1:10 Bulk TNRS, induced subtrees and study search in Python
1:45 Coffee break
2:00 Getting synthetic trees and dates in R
3:00 Adding trees to OpenTree
4:00 END

{% comment %} SETUP

Delete irrelevant sections from the setup instructions. Each section is inside a 'div' without any classes to make the beginning and end easier to find.

This is the other place where people frequently make mistakes, so please preview your site before committing, and make sure to run 'tools/check' as well. {% endcomment %}

Setup

To participate in this workshop, you will need to be able to access RStudio, Python3 and Jupyter notebooks, and use git to clone repos. In addition, you will need an up-to-date web browser.

If you already have these software installed and accessible on your laptop, please skip to the bottom and run the checks. Otherwise there are installation instructions listed below.

The Carpentries maintains a list of common issues that occur during installation as a reference for instructors that may be useful on the Configuration Problems and Solutions wiki page.

{% include setup.html %}

Installation checks (Please complete before the workshop starts)

Git check

You should be able to open a terminal window and run:

    git

This should print out some text that starts with "usage: git [--version] [--help] [-C ] [-c =]"

Jupyter check

    jupyter notebook

This should open up a browser window that says "jupyter" at the top. If you click on 'new' in the upper right, there should be an option to create a python3 notebook.

(You can close this window and close the terminal.)

RStudio check

Open RStudio. Click in the 'console' window. (It's the one with the '>')

Run:

    > version$version.string
    > install.packages("rotl")
    > install.packages(c("devtools", "ape", "stringr"))
    > devtools::install_github("phylotastic/datelife")

 

Make sure your version is at least 3.6.0 or higher. The r opentree installation output should end with "* DONE (rotl)"


If theses checks work, then you are all set! Otherwise, please follow the installation instructions above, and then try these tests again. Contact {{page.email}} if you are still having issues.