{ "cells": [ { "cell_type": "markdown", "metadata": { "slideshow": { "slide_type": "slide" } }, "source": [ "# Using r-obis and r-obistools to explore the OBIS database\n", "\n", "\n", "The [Ocean Biogeographic Information System (OBIS)](http://www.iobis.org) is an open-access data and information system for marine biodiversity for science, conservation and sustainable development.\n", "\n", "In this example we will use R libraries [`obistools`](https://iobis.github.io/obistools) and [`robis`](https://iobis.github.io/robis) to search data regarding marine turtles occurrence in the South Atlantic Ocean.\n", "\n", "Let's start by loading the R-to-Python extension and check the database for the 7 known species of marine turtles found in the world's oceans." ] }, { "cell_type": "code", "execution_count": 1, "metadata": { "slideshow": { "slide_type": "skip" } }, "outputs": [], "source": [ "import warnings\n", "\n", "warnings.simplefilter('ignore')" ] }, { "cell_type": "code", "execution_count": 2, "metadata": { "slideshow": { "slide_type": "slide" } }, "outputs": [], "source": [ "%load_ext rpy2.ipython" ] }, { "cell_type": "code", "execution_count": 3, "metadata": { "slideshow": { "slide_type": "fragment" } }, "outputs": [], "source": [ "%%R -o matches\n", "\n", "library(obistools)\n", "\n", "species <- c(\n", " 'Caretta caretta',\n", " 'Chelonia mydas',\n", " 'Dermochelys coriacea',\n", " 'Eretmochelys imbricata',\n", " 'Lepidochelys kempii',\n", " 'Lepidochelys olivacea',\n", " 'Natator depressa'\n", ")\n", "\n", "matches = match_taxa(species, ask=FALSE)" ] }, { "cell_type": "code", "execution_count": 4, "metadata": { "slideshow": { "slide_type": "slide" } }, "outputs": [ { "data": { "text/html": [ "
\n", "\n", "\n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", "
scientificNamescientificNameIDmatch_type
0Caretta carettaurn:lsid:marinespecies.org:taxname:137205exact
1Chelonia mydasurn:lsid:marinespecies.org:taxname:137206exact
2Dermochelys coriaceaurn:lsid:marinespecies.org:taxname:137209exact
3Eretmochelys imbricataurn:lsid:marinespecies.org:taxname:137207exact
4Lepidochelys kempiiurn:lsid:marinespecies.org:taxname:137208exact
5Lepidochelys olivaceaurn:lsid:marinespecies.org:taxname:220293exact
6Natator depressaurn:lsid:marinespecies.org:taxname:344093exact
\n", "
" ], "text/plain": [ " scientificName scientificNameID \\\n", "0 Caretta caretta urn:lsid:marinespecies.org:taxname:137205 \n", "1 Chelonia mydas urn:lsid:marinespecies.org:taxname:137206 \n", "2 Dermochelys coriacea urn:lsid:marinespecies.org:taxname:137209 \n", "3 Eretmochelys imbricata urn:lsid:marinespecies.org:taxname:137207 \n", "4 Lepidochelys kempii urn:lsid:marinespecies.org:taxname:137208 \n", "5 Lepidochelys olivacea urn:lsid:marinespecies.org:taxname:220293 \n", "6 Natator depressa urn:lsid:marinespecies.org:taxname:344093 \n", "\n", " match_type \n", "0 exact \n", "1 exact \n", "2 exact \n", "3 exact \n", "4 exact \n", "5 exact \n", "6 exact " ] }, "execution_count": 4, "metadata": {}, "output_type": "execute_result" } ], "source": [ "matches" ] }, { "cell_type": "markdown", "metadata": { "slideshow": { "slide_type": "slide" } }, "source": [ "We got a nice DataFrame back with records for all 7 species of turtles and their corresponding `ID` in the database.\n", "\n", "Now let us try to obtain the occurrence data for the South Atlantic. We will need a vector geometry for the ocean basin in the [well-known test (WKT)](https://en.wikipedia.org/wiki/Well-known_text) format to feed into the `robis` `occurrence` function.\n", "\n", "In this example we converted a South Atlantic shapefile to WKT with geopandas, but one can also obtain geometries by simply drawing them on a map with [iobis maptool](http://iobis.org/maptool)." ] }, { "cell_type": "code", "execution_count": 5, "metadata": { "slideshow": { "slide_type": "slide" } }, "outputs": [], "source": [ "import geopandas\n", "\n", "\n", "gdf = geopandas.read_file('data/oceans.shp')\n", "\n", "sa = gdf.loc[gdf['Oceans'] == 'South Atlantic Ocean']\n", "\n", "atlantic = sa['geometry'].loc[0].to_wkt()" ] }, { "cell_type": "code", "execution_count": 6, "metadata": { "slideshow": { "slide_type": "fragment" } }, "outputs": [ { "data": { "image/svg+xml": [ "" ], "text/plain": [ "" ] }, "execution_count": 6, "metadata": {}, "output_type": "execute_result" } ], "source": [ "sa['geometry'].loc[0].exterior" ] }, { "cell_type": "code", "execution_count": 7, "metadata": { "scrolled": true, "slideshow": { "slide_type": "slide" } }, "outputs": [ { "data": { "text/plain": [ "\r", "Retrieved 2000 records of 2309 (86%)\r", "Retrieved 2309 records of 2309 (100%)\n", " [1] \"id\" \"decimalLongitude\" \n", " [3] \"decimalLatitude\" \"eventDate\" \n", " [5] \"institutionCode\" \"collectionCode\" \n", " [7] \"catalogNumber\" \"datasetName\" \n", " [9] \"phylum\" \"order\" \n", "[11] \"family\" \"genus\" \n", "[13] \"scientificName\" \"originalScientificName\" \n", "[15] \"scientificNameAuthorship\" \"obisID\" \n", "[17] \"resourceID\" \"yearcollected\" \n", "[19] \"species\" \"qc\" \n", "[21] \"aphiaID\" \"speciesID\" \n", "[23] \"scientificNameID\" \"class\" \n", "[25] \"lifestage\" \"coordinatePrecision\" \n", "[27] \"basisOfRecord\" \"sex\" \n", "[29] \"individualCount\" \"bibliographicCitation\" \n", "[31] \"dynamicProperties\" \"associatedReferences\" \n", "[33] \"datasetID\" \"geodeticDatum\" \n", "[35] \"identificationRemarks\" \"modified\" \n", "[37] \"occurrenceID\" \"occurrenceRemarks\" \n", "[39] \"occurrenceStatus\" \"ownerInstitutionCode\" \n", "[41] \"recordNumber\" \"specificEpithet\" \n", "[43] \"taxonomicStatus\" \"taxonRank\" \n", "[45] \"taxonRemarks\" \"type\" \n", "[47] \"vernacularName\" \"locality\" \n", "[49] \"accessRights\" \"coordinateUncertaintyInMeters\"\n", "[51] \"eventID\" \"footprintWKT\" \n", "[53] \"language\" \"references\" \n", "[55] \"waterBody\" \"depth\" \n", "[57] \"minimumDepthInMeters\" \"maximumDepthInMeters\" \n", "[59] \"continent\" \"eventTime\" \n", "[61] \"recordedBy\" \"fieldNumber\" \n" ] }, "metadata": {}, "output_type": "display_data" } ], "source": [ "%%R -o turtles -i atlantic\n", "library(robis)\n", "\n", "\n", "turtles = occurrence(\n", " species,\n", " geometry=atlantic,\n", ")\n", "\n", "names(turtles)" ] }, { "cell_type": "code", "execution_count": 8, "metadata": { "slideshow": { "slide_type": "slide" } }, "outputs": [ { "data": { "text/plain": [ "{'Caretta caretta',\n", " 'Chelonia mydas',\n", " 'Dermochelys coriacea',\n", " 'Eretmochelys imbricata',\n", " 'Lepidochelys kempii',\n", " 'Lepidochelys olivacea'}" ] }, "execution_count": 8, "metadata": {}, "output_type": "execute_result" } ], "source": [ "set(turtles['scientificName'])" ] }, { "cell_type": "markdown", "metadata": { "slideshow": { "slide_type": "slide" } }, "source": [ "Note that there are no occurrences for *Natator depressa* (Flatback sea turtle) in the South Atlantic.\n", "The Flatback sea turtle can only be found in the waters around the Australian continental shelf.\n", "\n", "\n", "With `ggplot2` we can quickly put together a of occurrences over time." ] }, { "cell_type": "code", "execution_count": 9, "metadata": { "slideshow": { "slide_type": "slide" } }, "outputs": [ { "data": { "image/png": "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\n" }, "metadata": {}, "output_type": "display_data" } ], "source": [ "%%R\n", "library(ggplot2)\n", "\n", "turtles$year <- as.numeric(format(as.Date(turtles$eventDate), \"%Y\"))\n", "table(turtles$year)\n", "\n", "ggplot() + geom_histogram(\n", " data=turtles,\n", " aes(x=year, fill=scientificName),\n", " binwidth=5) + scale_fill_brewer(palette='Paired')" ] }, { "cell_type": "markdown", "metadata": { "slideshow": { "slide_type": "slide" } }, "source": [ "One would guess that the 2010 count increase would be due to an increase in the sampling effort, but the drop around 2010 seems troublesome. It can be a real threat to these species, or the observation efforts were defunded.\n", "\n", "\n", "To explore this dataset further we can make use of the `obistools`' R package. `obistools` has many visualization and quality control routines built-in. Here is an example on how to use `plot_map` to quickly visualize the data on a geographic context." ] }, { "cell_type": "code", "execution_count": 10, "metadata": { "scrolled": false, "slideshow": { "slide_type": "slide" } }, "outputs": [ { "data": { "image/png": "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ePzxxydHe/zxx5944ok8z3/3d3/3xIkT586de+aZZyaf+vM///OVlZWzZ89++tOfPqyLZdODR9Dsrvev//qvX//61ycZ+ku/9Evnzp0rl8v/9E//dO3atUaj8Wu/9mtPPvlkHMfPPffc888/v7Gxcfbs2YcffnjyvV/60peeeeaZL37xi0888cQrDvs3f/M3Fy9ePH/+fK/Xe+CBB971rnd94xvf+Pu///v/+Z//cRzn0Ucf/du//dvf+q3fOuirZdOER9DsrvfNb37zscceC8MwDMOPfOQjk+p97373uxuNBgCsrKwkSfLkk0/+9m//tlJqYWHhF3/xF9/IYf/jP/7j4x//uOu6nU7nkUcemTxQt9t99NFHP/jBD168ePGpp566k5fFGI+g2d2PiBBx8jEiGmMAoNlsvvxrjDFC3BiOOI5z6wOur68DgBBi97BSSgAIw/B3fud3/vAP/3ByQN6Fy+40HkGzu9573/ver371q0mSxHH81a9+9X3ve99Nv+YrX/mKMWZzc/Pf//3fX/4prTUA+L7/gx/8wFq7vr4+GYO/973v/au/+iut9c7Ozj/+4z8CwPvf//6/+7u/Gw6HeZ7/yq/8yj//8z8fwNWxacYjaHbX+8AHPvBf//Vf73jHO4joN3/zNx9++OFvf/vbu58VQiilPvrRjz711FNnzpw5derUhz70oXq9PvlsvV6v1+uPP/74X/7lX957771vfetbz549+4lPfKJUKj3++OPf/e53z5w50263P/rRjzYajQceeOCxxx574IEH4jh+5JFHPvShDx3SFbNpwcWS2FT41re+9cILL3zsYx8zxjz00EN//dd/ffLkycM+KcZeBwc0mwrdbvexxx5bW1sDgEceeWQyj8xYwXFAM8ZYQfFNQsYYKygOaMYYKygOaMYYKygOaMYYKygOaMYYKygOaMYYKygOaMYYKygOaMYYKygOaMYYKygOaMYYKygOaMYYKygOaMYYKygOaMYYKygOaMYYKygOaMYYKygOaMYYKygOaMYYKygOaMYYKygOaMYYKygOaMYYKygOaMYYKygOaMYYKygOaMYYKygOaMYYKygOaMYYKygOaMYYKygOaMYYKygOaMYYKygOaMYYKygOaMYYKygOaMYYKygOaMYYKygOaMYYKygOaMYYKygOaMYYKygOaMYYKygOaMYYKygOaMYYKygOaMYYKygOaMYYKygOaMYYKygOaMYYKygOaMYYKygOaMYYKygOaMYYKygOaMYYKygOaMYYKygOaMYYKygOaMYYKygOaMYYKygOaMYYKygOaMYYKygOaMYYKygOaMYYKygOaMYYKygOaMYYKygOaMYYKygOaMYYKygOaMYYKygOaMYYKygOaMYYKygOaMYYKygOaMYYKygOaMYYKygOaMYYKygOaMYYKygOaMYYKygOaMYYKygOaMYYKygOaMYYKygOaMYYKygOaMYYKygOaMYYKygOaMYYKygOaMYYKygOaMYYKygOaMYYKygOaMYYKygOaMYYKygOaMYYKygOaMYYKygOaMYYKygOaMYYKygOaMYYKygOaMYYKygOaMYYKygOaMYYKygOaMYYKygOaMYYKygOaMYYKygOaMYYKygOaMYYKygOaMYYKygOaMYYKygOaMYYKygOaMYYKygOaMYYKygOaMYYKygOaMYYKygOaMYYKygOaMYYKygOaMYYKygOaMYYKygOaMYYKygOaMYYKygOaMYYKygOaMYYKygOaMYYK6j/Hzrxlq8G2ospAAAAAElFTkSuQmCC\n" }, "metadata": {}, "output_type": "display_data" } ], "source": [ "%%R\n", "\n", "library(dplyr)\n", "\n", "coriacea <- turtles %>% filter(species=='Dermochelys coriacea')\n", "plot_map(coriacea, zoom=TRUE)" ] }, { "cell_type": "markdown", "metadata": { "slideshow": { "slide_type": "slide" } }, "source": [ "However, if we want to create a slightly more elaborate map with clusters and informative pop-ups, can use the python library `folium` instead." ] }, { "cell_type": "code", "execution_count": 11, "metadata": { "slideshow": { "slide_type": "fragment" } }, "outputs": [], "source": [ "import folium\n", "from pandas import DataFrame\n", "\n", "def filter_df(df):\n", " return df[['lifestage',\n", " 'institutionCode',\n", " 'individualCount',\n", " 'sex',\n", " 'eventDate']]\n", "\n", "def make_popup(row):\n", " classes = ('table table-striped table-hover table-condensed '\n", " 'table-responsive')\n", " html = DataFrame(row).to_html(classes=classes)\n", " return folium.Popup(html)\n", "\n", "def make_marker(row, popup=None):\n", " location = row['decimalLatitude'], row['decimalLongitude']\n", " return folium.Marker(location=location, popup=popup)" ] }, { "cell_type": "code", "execution_count": 12, "metadata": { "slideshow": { "slide_type": "slide" } }, "outputs": [], "source": [ "from folium.plugins import MarkerCluster\n", "\n", "\n", "species_found = sorted(set(turtles['scientificName']))\n", "\n", "clusters = {s: MarkerCluster() for s in species_found}\n", "groups = {s: folium.FeatureGroup(name=s) for s in species_found}" ] }, { "cell_type": "code", "execution_count": 13, "metadata": { "slideshow": { "slide_type": "skip" } }, "outputs": [], "source": [ "def embed_map(m):\n", " from IPython.display import HTML\n", "\n", " m.save('index.html')\n", " with open('index.html') as f:\n", " html = f.read()\n", "\n", " iframe = ''\n", " srcdoc = html.replace('\"', '"')\n", " return HTML(iframe.format(srcdoc=srcdoc))" ] }, { "cell_type": "code", "execution_count": 14, "metadata": { "slideshow": { "slide_type": "slide" } }, "outputs": [], "source": [ "m = folium.Map()\n", "\n", "for turtle in species_found:\n", " df = turtles.loc[turtles['scientificName'] == turtle]\n", " for k, row in df.iterrows():\n", " popup = make_popup(filter_df(row))\n", " make_marker(row, popup=popup).add_to(clusters[turtle])\n", " clusters[turtle].add_to(groups[turtle])\n", " groups[turtle].add_to(m)\n", "\n", "\n", "m.fit_bounds(m.get_bounds())\n", "folium.LayerControl().add_to(m);" ] }, { "cell_type": "code", "execution_count": 15, "metadata": { "slideshow": { "slide_type": "slide" } }, "outputs": [ { "data": { "text/html": [ "" ], "text/plain": [ "" ] }, "execution_count": 15, "metadata": {}, "output_type": "execute_result" } ], "source": [ "embed_map(m)" ] }, { "cell_type": "code", "execution_count": 16, "metadata": { "slideshow": { "slide_type": "slide" } }, "outputs": [ { "data": { "image/png": "iVBORw0KGgoAAAANSUhEUgAAAwEAAAJcCAYAAACheKiIAAAABHNCSVQICAgIfAhkiAAAAAlwSFlzAAALEgAACxIB0t1+/AAAADl0RVh0U29mdHdhcmUAbWF0cGxvdGxpYiB2ZXJzaW9uIDIuMi4yLCBodHRwOi8vbWF0cGxvdGxpYi5vcmcvhp/UCwAAIABJREFUeJzs3Xm89WO9//HXG0kRGjQZImlQiG7RdE6oU5o0KDSpHJpTOpVGqlNpHuSQkqNOk1QnjZShmTJL9MuhogklKgl5//64ruVe977X3ve+3Xvv61r3ej8fD4+91netvXxse6/1/Xyvz/X5yDYRERERETE5VmkdQERERERELKwkAREREREREyZJQERERETEhEkSEBERERExYZIERERERERMmCQBERERERETJklARERERMSESRIQERERETFhkgREREREREyY1VoHAHCHO9zBG2+8ceswIiIiIiLG1umnn36F7fVm89wukoCNN96Y0047rXUYERERERFjS9KvZvvclANFREREREyYJAERERERERMmSUBERERExIRJEhARERERMWGSBERERERETJgkAREREREREyZJQERERETEhEkSEBERERExYboYFrY8Nt7/a3P+mr886LFz/poREREREb3KSkBERERExIRJEhARERERMWGSBERERERETJgkAREREREREyZJQERERETEhEkSEBERERExYZIERERERERMmCQBERERERETJklARERERMSESRIQERERETFhkgREREREREyYJAERERERERMmSUBERERExIRJEhARERERMWGSBERERERETJgkAREREREREyZJQERERETEhJlVEiDpFZLOk/RTSZ+RtIakTSSdKukXkj4nafX63FvW+xfWxzeez/+AiIiIiIhYPstMAiStD7wMWGT7fsCqwO7AO4H3294MuBLYq37LXsCVtu8BvL8+LyIiIiIiOjHbcqDVgFtJWg24NfA7YEfgmPr4UcAT6+1d6n3q4ztJ0tyEGxERERERK2qZSYDt3wDvAX5NOfm/Cjgd+LPtG+rTLgXWr7fXBy6p33tDff7tp76upH0knSbptMsvv3xF/zsiIiIiImKWZlMOdFvK1f1NgLsCawI7j3iqB98yw2OLD9iH215ke9F66603+4gjIiIiImKFzKYc6BHAxbYvt3098EXgwcC6tTwIYAPgt/X2pcCGAPXxdYA/zWnUERERERFxs80mCfg1sL2kW9fa/p2AnwEnAbvW5+wJfLnePrbepz5+ou2lVgIiIiIiIqKN2ewJOJWywfcM4Nz6PYcDrwH2k3Qhpeb/iPotRwC3r8f3A/afh7gjIiIiIuJmWm3ZTwHbBwAHTDl8EfDAEc+9FnjqiocWERERERHzIRODIyIiIiImTJKAiIiIiIgJkyQgIiIiImLCJAmIiIiIiJgwSQIiIiIiIiZMkoCIiIiIiAmTJCAiIiIiYsIkCYiIiIiImDBJAiIiIiIiJkySgIiIiIiICZMkICIiIiJiwiQJiIiIiIiYMEkCIiIiIiImTJKAiIiIiIgJkyQgIiIiImLCJAmIiIiIiJgwSQIiIiIiIiZMkoCIiIiIiAmTJCAiIiIiYsIkCYiIiIiImDBJAiIiIiIiJkySgIiIiIiICZMkICIiIiJiwiQJiIiIiIiYMEkCIiIiIiImTJKAiIiIiIgJkyQgIiIiImLCJAmIiIiIiJgwSQIiIiIiIiZMkoCIiIiIiAmTJCAiIiIiYsIkCYiIiIiImDBJAiIiIiIiJkySgIiIiIiICTOrJEDSupKOkXSBpPMlPUjS7SR9S9Iv6tfb1udK0ockXSjpHEnbzO9/QkRERERELI/ZrgR8EPim7XsDWwHnA/sDJ9jeDDih3gfYGdis/rMPcOicRhwREREREStkmUmApLWBfwGOALB9ne0/A7sAR9WnHQU8sd7eBfiEi1OAdSXdZc4jj4iIiIiIm2U2KwF3By4HjpR0pqSPSVoTuJPt3wHUr3esz18fuGTo+y+txyIiIiIiogOzSQJWA7YBDrW9NfA3Fpf+jKIRx7zUk6R9JJ0m6bTLL798VsFGRERERMSKm00ScClwqe1T6/1jKEnBHwZlPvXrZUPP33Do+zcAfjv1RW0fbnuR7UXrrbfezY0/IiIiIiKW0zKTANu/By6RdK96aCfgZ8CxwJ712J7Al+vtY4Fn1y5B2wNXDcqGIiIiIiKivdVm+byXAp+StDpwEfBcSgJxtKS9gF8DT63P/TrwGOBC4Jr63IiIiIiI6MSskgDbZwGLRjy004jnGnjxCsYVERERERHzJBODIyIiIiImTJKAiIiIiIgJkyQgIiIiImLCJAmIiIiIiJgwSQIiIiIiIiZMkoCIiIiIiAmTJCAiIiIiYsIkCYiIiIiImDBJAiIiIiIiJkySgIiIiIiICZMkICIiIiJiwiQJiIiIiIiYMEkCIiIiIiImTJKAiIiIiIgJkyQgIiIiImLCJAmIiIiIiJgwSQIiIiIiIibMaq0DWGkduM48ve5V8/O6ERERETExshIQERERETFhkgREREREREyYJAERERERERMmSUBERERExIRJEhARERERMWGSBERERERETJgkAREREREREyZJQERERETEhEkSEBERERExYZIERERERERMmCQBERERERETJklARERERMSESRIQERERETFhkgREREREREyYJAERERERERMmSUBERERExISZdRIgaVVJZ0r6ar2/iaRTJf1C0uckrV6P37Lev7A+vvH8hB4RERERETfH8qwE7AucP3T/ncD7bW8GXAnsVY/vBVxp+x7A++vzIiIiIiKiE7NKAiRtADwW+Fi9L2BH4Jj6lKOAJ9bbu9T71Md3qs+PiIiIiIgOzHYl4APAq4Eb6/3bA3+2fUO9fymwfr29PnAJQH38qvr8iIiIiIjowDKTAEmPAy6zffrw4RFP9SweG37dfSSdJum0yy+/fFbBRkRERETEipvNSsBDgCdI+iXwWUoZ0AeAdSWtVp+zAfDbevtSYEOA+vg6wJ+mvqjtw20vsr1ovfXWW6H/iIiIiIiImL1lJgG2X2t7A9sbA7sDJ9p+BnASsGt92p7Al+vtY+t96uMn2l5qJSAiIiIiItpYkTkBrwH2k3Qhpeb/iHr8COD29fh+wP4rFmJERERERMyl1Zb9lMVsnwycXG9fBDxwxHOuBZ46B7FFRERERMQ8yMTgiIiIiIgJkyQgIiIiImLCJAmIiIiIiJgwSQIiIiIiIiZMkoCIiIiIiAmTJCAiIiIiYsIkCYiIiIiImDBJAiIiIiIiJkySgIiIiIiICZMkICIiIiJiwiQJiIiIiIiYMKu1DiDa2+KoLeb8Nc/d89w5f82IiIiImBtZCYiIiIiImDBJAiIiIiIiJkySgIiIiIiICZMkICIiIiJiwiQJiIiIiIiYMEkCIiIiIiImTJKAiIiIiIgJkyQgIiIiImLCJAmIiIiIiJgwSQIiIiIiIiZMkoCIiIiIiAmTJCAiIiIiYsIkCYiIiIiImDBJAiIiIiIiJkySgIiIiIiICZMkICIiIiJiwiQJiIiIiIiYMEkCIiIiIiImTJKAiIiIiIgJkyQgIiIiImLCJAmIiIiIiJgwSQIiIiIiIibMMpMASRtKOknS+ZLOk7RvPX47Sd+S9Iv69bb1uCR9SNKFks6RtM18/0dERERERMTszWYl4AbglbbvA2wPvFjS5sD+wAm2NwNOqPcBdgY2q//sAxw651FHRERERMTNtswkwPbvbJ9Rb/8FOB9YH9gFOKo+7SjgifX2LsAnXJwCrCvpLnMeeURERERE3CzLtSdA0sbA1sCpwJ1s/w5KogDcsT5tfeCSoW+7tB6LiIiIiIgOzDoJkLQW8AXg5bavnumpI455xOvtI+k0Saddfvnlsw0jIiIiIiJW0KySAEm3oCQAn7L9xXr4D4Myn/r1snr8UmDDoW/fAPjt1Ne0fbjtRbYXrbfeejc3/oiIiIiIWE6z6Q4k4AjgfNvvG3roWGDPentP4MtDx59duwRtD1w1KBuKiIiIiIj2VpvFcx4CPAs4V9JZ9djrgIOAoyXtBfwaeGp97OvAY4ALgWuA585pxBERERERsUKWmQTY/j6j6/wBdhrxfAMvXsG4IiIiIiJinmRicERERETEhEkSEBERERExYZIERERERERMmCQBERERERETJklARERERMSESRIQERERETFhkgREREREREyYJAERERERERMmSUBERERExIRJEhARERERMWGSBERERERETJgkAREREREREyZJQERERETEhFmtdQARy+P8e99nzl/zPhecP+evGREREdGzJAER8+CQF5w4L6/74sN2nJfXjYiIiMmScqCIiIiIiAmTJCAiIiIiYsKkHChiwr13t8fN+Wu+8nNfnfPXjIiIiLmTlYCIiIiIiAmTJCAiIiIiYsIkCYiIiIiImDBJAiIiIiIiJkySgIiIiIiICZMkICIiIiJiwiQJiIiIiIiYMJkTEBFj49L9vzfnr7nBQQ+b89eMiIjoXVYCIiIiIiImTFYCIiLm2IEHHjhWrxsREZMnSUBExAQ74cRN5/w1d9rx/+b8NSMiYm6lHCgiIiIiYsJkJSAiIsbCnU86a85f8/c73H/OXzMiYhxkJSAiIiIiYsJkJSAiImIObbz/1+bldX950GPn5XUjYjJlJSAiIiIiYsIkCYiIiIiImDDzUg4k6dHAB4FVgY/ZPmg+/j0RERFx881H6VLKliLGw5wnAZJWBQ4BHglcCvxE0rG2fzbX/66IiIiY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\n", "text/plain": [ "
" ] }, "metadata": {}, "output_type": "display_data" } ], "source": [ "%matplotlib inline\n", "\n", "inst = turtles['institutionCode'].value_counts()\n", "\n", "inst.plot.bar(figsize=(13, 3.75));" ] }, { "cell_type": "markdown", "metadata": { "slideshow": { "slide_type": "slide" } }, "source": [ "We can get fancy and use shapely to \"merge\" the points that are on the ocean and get an idea of migrations routes.\n", "\n", "First let's use `obistools` QA/QC functions to eliminate the points that fall on land." ] }, { "cell_type": "code", "execution_count": 17, "metadata": { "scrolled": false, "slideshow": { "slide_type": "slide" } }, "outputs": [ { "data": { "image/png": "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EEIcPnz4Ot+DEke7jI6Ojo6OrqSF1c/lNWQYxmVdCQBAQMNVfOhDH8J6e51l586dW7duXeuzgFtw//333/DP69WuQQMAwE3CMDsAAEWhxAEfMDs7+41vfKNUKhFCHn/88VKp9PTTT9dqtdHR0YMHD6712cHVxXGM29QRbvX9hYCGD5iZmdm7d+/+/fvTT48fPz40NPS5z33uu9/97sTEBJ7jqen111/HbeoIt/r+QokDPmBqauq999575plnXn31VULImTNnxsbGCCFjY2NnzpxZ45ODa8Bt6hS3+v5CDxo+wHGcu+666+67737qqacKhUKj0UiHJPf19dVqtbU+O7g63KZOcavvLwQ0EELIsWPH3njjjd27d+/atSv9lwceeOCtt95yHGdubm5sbGxubi4tnIGCcJs6xc6dO9MPbvL9hRIHEELInj17vv71r+/atev5558/efIkIeT8+fMbNmzYunXruXPn0k+3bNmyxmcJ14Db1Clu9f2FcdDwATMzMz/84Q81Tevr6zt8+LAQ4plnnomiqFQqHThwYK3PDq4ujmPcpo5wq+8vBDQAgKJQ4gAAUBQCGgBAUQhoAABFIaABABSFgIYO9vvf//7zn/98c6/95S9/uWPHjrm5uTvuuOOG3/y9733vqaeeau5AAE3DRBVYp/bu3bt79+61PguA60EPGrrBk08+uWXLlq1bt6Z7Pr322muPPPLIt771rYceemj//v31el0I8cQTT2zevHn37t379+8/cuTIqVOnnnjiiccee+z8+fNf+9rXjh49eujQobS1Q4cOHT16NIqir371q5s2bdq1a9epU6fSL/3gBz8YGxvbvn37k08+uVYXC+sHetDQ8V566aWXX345zdD7779/165druv+5je/mZyc7O3t/cxnPnPs2DHP8/75z3+ePn16enp6+/bte/fuTV/7ox/96NSpU88+++zRo0cva/ZnP/vZuXPn3nrrrYWFhR07duzcufOVV1554YUX/vKXv+i6vn///p///Odf/OIXV/tqYT1BDxo63quvvnrgwAHHcRzHeeSRR9J1wj72sY/19vYSQsbGxnzfP3bs2Je//GVN04aGhj7+8Y/fTLN//OMfH3vsMcMwSqXSvn370gOVy+X9+/c/9NBD586dO3HiRDsvCwA9aOh8UkpKafoxpTRJEkJIoVBY/j1JkjD2v90RXdev3+DU1BQhhDG21CznnBDiOM5XvvKVb37zm2mDmIUL7YYeNHS8++6777nnnvN93/O855577hOf+MRVv+fIkSNJkszMzPzhD39Y/qU4jgkhlmX94x//EEJMTU2lffD77rvvJz/5SRzH8/Pzv/rVrwghDz744C9+8YtqtRpF0Sc/+ckXX3xxFa4O1jP0oKHjffrTn/7zn//8kY98REr5hS98Ye/eva+99trSVxljmqY9+uijJ06cGB8f37Jly8MPP5zP59Ov5vP5fD5/6NChH//4x9u2bbvrrru2b99++PDhTCZz6NChv/3tb+Pj48Vi8dFHH+3t7d2xY8eBAwd27Njhed6+ffsefvjhNbpiWC+wWBKsC8ePHz979uzBgweTJNmzZ89Pf/rTzZs3r/VJAdwAAhrWhXK5fODAgYsXLxJC9u3bl9aRARSHgAYAUBQeEgIAKAoBDQCgKAQ0AICiENAAAIpCQAMAKAoBDQCgKAQ0AICiENAAAIpCQAMAKAoBDQCgKAQ0AICiENAAAIpCQAMAKAoBDQCgKAQ0AICiENAAAIpCQAMAKAoBDQCgKAQ0AICiENAAAIpCQAMAKAoBDQCgKAQ0AICiENAAAIpCQAMAKAoBDQCgKAQ0AICiENAAAIpCQAMAKAoBDQCgKAQ0AICiENAAAIpCQAMAKAoBDQCgKAQ0AICiENAAAIpCQAMAKAoBDQCgKAQ0AICiENAAAIpCQAMAKAoBDQCgKAQ0AICiENAAAIpCQAMAKAoBDQCgKAQ0AICiENAAAIpCQAMAKAoBDQCgKAQ0AICiENAAAIpCQAMAKAoBDQCgKAQ0AICiENAAAIpCQAMAKAoBDQCgKAQ0AICiENAAAIpCQAMAKAoBDQCgKAQ0AICiENAAAIpCQAMAKAoBDQCgKAQ0AICiENAAAIpCQAMAKAoBDQCgKAQ0AICiENAAAIpCQAMAKAoBDQCgKAQ0AICiENAAAIpCQAMAKAoBDQCgKAQ0AICiENAAAIpCQAMAKAoBDQCgKAQ0AICiENAAAIpCQAMAKAoBDQCgKAQ0AICiENAAAIpCQAMAKAoBDQCgKAQ0AICiENAAAIpCQAMAKAoBDQCgKAQ0AICiENAAAIpCQAMAKAoBDQCgKAQ0AICiENAAAIpCQAMAKAoBDQCgKAQ0AICiENAAAIpCQAMAKAoBDQCgKAQ0AICiENAAAIpCQAMAKAoBDQCgKAQ0AICiENAAAIpCQAMAKAoBDQCgKAQ0AICiENAAAIpCQAMAKAoBDQCgKAQ0AICiENAAAIr6H7hM2wij5qASAAAAAElFTkSuQmCC\n" }, "metadata": {}, "output_type": "display_data" } ], "source": [ "%%R -o land\n", "\n", "land <- check_onland(turtles)\n", "\n", "plot_map(land, zoom=TRUE)" ] }, { "cell_type": "code", "execution_count": 18, "metadata": { "slideshow": { "slide_type": "slide" } }, "outputs": [], "source": [ "turtles.set_index('id', inplace=True)\n", "land.set_index('id', inplace=True)\n", "\n", "mask = turtles.index.isin(land.index)\n", "ocean = turtles[~mask]" ] }, { "cell_type": "markdown", "metadata": { "slideshow": { "slide_type": "slide" } }, "source": [ "Now we can use shapely's buffer to \"connect\" the points that are close to each other to visualize a possible migration path." ] }, { "cell_type": "code", "execution_count": 19, "metadata": { "slideshow": { "slide_type": "skip" } }, "outputs": [], "source": [ "from palettable.cartocolors.qualitative import Bold_6\n", "\n", "\n", "colors = {s: c for s, c in zip(species_found, Bold_6.hex_colors)}\n", "style_function = lambda color: (lambda feature: dict(color=color, weight=2, opacity=0.6))" ] }, { "cell_type": "code", "execution_count": 20, "metadata": { "scrolled": false, "slideshow": { "slide_type": "slide" } }, "outputs": [], "source": [ "from folium.plugins import Fullscreen\n", "from shapely.geometry import MultiPoint\n", "from shapely.ops import polygonize\n", "\n", "m = folium.Map()\n", "Fullscreen().add_to(m)\n", "\n", "for turtle in species_found:\n", " df = ocean.loc[ocean['scientificName'] == turtle]\n", " positions = MultiPoint(\n", " list(zip(\n", " df['decimalLongitude'].values,\n", " df['decimalLatitude'].values)\n", " )\n", " ).buffer(distance=2)\n", " folium.GeoJson(\n", " positions.__geo_interface__,\n", " name=turtle,\n", " tooltip=turtle,\n", " style_function=style_function(color=colors[turtle]),\n", " ).add_to(m)\n", " \n", "m.fit_bounds(m.get_bounds())\n", "folium.LayerControl().add_to(m);" ] }, { "cell_type": "code", "execution_count": 21, "metadata": { "slideshow": { "slide_type": "slide" } }, "outputs": [ { "data": { "text/html": [ "
" ], "text/plain": [ "" ] }, "execution_count": 21, "metadata": {}, "output_type": "execute_result" } ], "source": [ "m" ] }, { "cell_type": "markdown", "metadata": { "slideshow": { "slide_type": "slide" } }, "source": [ "One interesting feature of this map is *Dermochelys coriacea*'s migration between Brazilian and African shores.\n", "\n", "More information on [*Dermochelys coriacea*](http://www.iucnredlist.org/details/6494/0) and the other Sea Turtles can be found in the species [IUCN red list](http://www.iucnredlist.org)." ] } ], "metadata": { "celltoolbar": "Slideshow", "kernelspec": { "display_name": "Python 3", "language": "python", "name": "python3" }, "language_info": { "codemirror_mode": { "name": "ipython", "version": 3 }, "file_extension": ".py", "mimetype": "text/x-python", "name": "python", "nbconvert_exporter": "python", "pygments_lexer": "ipython3", "version": "3.6.5" } }, "nbformat": 4, "nbformat_minor": 2 }