Skip to content

Commit

Permalink
Update docs
Browse files Browse the repository at this point in the history
  • Loading branch information
estebanzimanyi committed Sep 21, 2023
1 parent 789220e commit 6f51499
Show file tree
Hide file tree
Showing 24 changed files with 85 additions and 82 deletions.
4 changes: 2 additions & 2 deletions docs/html/ch01.html
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>Chapter 1. Managing Ship Trajectories (AIS)</title><link rel="stylesheet" type="text/css" href="docbook.css"><meta name="generator" content="DocBook XSL Stylesheets Vsnapshot"><link rel="home" href="index.html" title="MobilityDB Workshop"><link rel="up" href="index.html" title="MobilityDB Workshop"><link rel="prev" href="index.html" title="MobilityDB Workshop"><link rel="next" href="ch01s02.html" title="Data"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">Chapter 1. Managing Ship Trajectories (AIS)</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="index.html">Prev</a> </td><th width="60%" align="center"> </th><td width="20%" align="right"> <a accesskey="n" href="ch01s02.html">Next</a></td></tr></table><hr></div><div class="chapter"><div class="titlepage"><div><div><h1 class="title"><a name="AIS"></a>Chapter 1. Managing Ship Trajectories (AIS)</h1></div></div></div><div class="toc"><p><b>Table of Contents</b></p><dl class="toc"><dt><span class="section"><a href="ch01.html#idm45">Contents</a></span></dt><dt><span class="section"><a href="ch01s02.html">Data</a></span></dt><dt><span class="section"><a href="ch01s03.html">Tools</a></span></dt><dt><span class="section"><a href="ch01s04.html">Preparing the Database</a></span></dt><dt><span class="section"><a href="ch01s05.html">Loading the Data</a></span></dt><dt><span class="section"><a href="ch01s06.html">Constructing Trajectories</a></span></dt><dt><span class="section"><a href="ch01s07.html">Basic Data Exploration</a></span></dt><dt><span class="section"><a href="ch01s08.html">Analyzing the Trajectories</a></span></dt></dl></div><p> AIS stands for Automatic Identification System. It is the location tracking system for sea vessels. This module illustrates how to load big AIS data sets into MobilityDB and do basic exploration.
<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>Chapter 1. Managing Ship Trajectories (AIS)</title><link rel="stylesheet" type="text/css" href="docbook.css"><meta name="generator" content="DocBook XSL Stylesheets Vsnapshot"><link rel="home" href="index.html" title="MobilityDB Workshop"><link rel="up" href="index.html" title="MobilityDB Workshop"><link rel="prev" href="index.html" title="MobilityDB Workshop"><link rel="next" href="ch01s02.html" title="Data"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">Chapter 1. Managing Ship Trajectories (AIS)</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="index.html">Prev</a> </td><th width="60%" align="center"> </th><td width="20%" align="right"> <a accesskey="n" href="ch01s02.html">Next</a></td></tr></table><hr></div><div class="chapter"><div class="titlepage"><div><div><h1 class="title"><a name="AIS"></a>Chapter 1. Managing Ship Trajectories (AIS)</h1></div></div></div><div class="toc"><p><b>Table of Contents</b></p><dl class="toc"><dt><span class="section"><a href="ch01.html#idm44">Contents</a></span></dt><dt><span class="section"><a href="ch01s02.html">Data</a></span></dt><dt><span class="section"><a href="ch01s03.html">Tools</a></span></dt><dt><span class="section"><a href="ch01s04.html">Preparing the Database</a></span></dt><dt><span class="section"><a href="ch01s05.html">Loading the Data</a></span></dt><dt><span class="section"><a href="ch01s06.html">Constructing Trajectories</a></span></dt><dt><span class="section"><a href="ch01s07.html">Basic Data Exploration</a></span></dt><dt><span class="section"><a href="ch01s08.html">Analyzing the Trajectories</a></span></dt></dl></div><p> AIS stands for Automatic Identification System. It is the location tracking system for sea vessels. This module illustrates how to load big AIS data sets into MobilityDB and do basic exploration.
</p><p>
The idea of this module is inspired from the tutorial of <a class="ulink" href="https://github.com/anitagraser/movingpandas" target="_top">MovingPandas</a> on ship data analysis by Anita Graser.
</p><div class="section"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="idm45"></a>Contents</h2></div></div></div><p>This module covers the following topics:
</p><div class="section"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="idm44"></a>Contents</h2></div></div></div><p>This module covers the following topics:
</p><div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "><li class="listitem"><p>Loading large trajectory datasets into MobilityDB</p></li><li class="listitem"><p>Create proper indexes to speed up trajectory construction</p></li><li class="listitem"><p>Select trajectories by a spatial window</p></li><li class="listitem"><p>Join trajectories tables by proximity</p></li><li class="listitem"><p>Select certain parts inside individual trajectories</p></li><li class="listitem"><p>Manage the temporal speed and azimuth features of ships</p></li></ul></div><p>
</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="index.html">Prev</a> </td><td width="20%" align="center"> </td><td width="40%" align="right"> <a accesskey="n" href="ch01s02.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">MobilityDB Workshop </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> Data</td></tr></table></div></body></html>
2 changes: 1 addition & 1 deletion docs/html/ch01s02.html
Original file line number Diff line number Diff line change
@@ -1,3 +1,3 @@
<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>Data</title><link rel="stylesheet" type="text/css" href="docbook.css"><meta name="generator" content="DocBook XSL Stylesheets Vsnapshot"><link rel="home" href="index.html" title="MobilityDB Workshop"><link rel="up" href="ch01.html" title="Chapter 1. Managing Ship Trajectories (AIS)"><link rel="prev" href="ch01.html" title="Chapter 1. Managing Ship Trajectories (AIS)"><link rel="next" href="ch01s03.html" title="Tools"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">Data</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="ch01.html">Prev</a> </td><th width="60%" align="center">Chapter 1. Managing Ship Trajectories (AIS)</th><td width="20%" align="right"> <a accesskey="n" href="ch01s03.html">Next</a></td></tr></table><hr></div><div class="section"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="idm61"></a>Data</h2></div></div></div><p>
<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>Data</title><link rel="stylesheet" type="text/css" href="docbook.css"><meta name="generator" content="DocBook XSL Stylesheets Vsnapshot"><link rel="home" href="index.html" title="MobilityDB Workshop"><link rel="up" href="ch01.html" title="Chapter 1. Managing Ship Trajectories (AIS)"><link rel="prev" href="ch01.html" title="Chapter 1. Managing Ship Trajectories (AIS)"><link rel="next" href="ch01s03.html" title="Tools"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">Data</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="ch01.html">Prev</a> </td><th width="60%" align="center">Chapter 1. Managing Ship Trajectories (AIS)</th><td width="20%" align="right"> <a accesskey="n" href="ch01s03.html">Next</a></td></tr></table><hr></div><div class="section"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="idm60"></a>Data</h2></div></div></div><p>
The Danish Maritime Authority publishes about 3 TB of AIS routes in CSV format <a class="ulink" href="https://web.ais.dk/aisdata/" target="_top">here</a>. The columns in the CSV are listed in <a class="xref" href="ch01s02.html#tabdata" title="Table 1.1. AIS columns">Table 1.1, “AIS columns”</a>. This module uses the data of one day June 1<sup>st</sup> 2023. The CSV file size is 582 MB, and it contains more than 11 M rows.
</p><div class="table"><a name="tabdata"></a><p class="title"><b>Table 1.1. AIS columns</b></p><div class="table-contents"><table class="table" summary="AIS columns" width="100%" border="1"><colgroup><col align="left" class="c1"><col align="left" class="c2"></colgroup><tbody><tr><td align="left">Timestamp</td><td align="left">Timestamp from the AIS base station, format: 31/12/2015 23:59:59</td></tr><tr><td align="left">Type of mobile</td><td align="left">Describes what type of target this message is received from (class A AIS Vessel, Class B AIS vessel, etc)</td></tr><tr><td align="left">MMSI</td><td align="left">MMSI number of vessel</td></tr><tr><td align="left">Latitude</td><td align="left">Latitude of message report (e.g. 57,8794)</td></tr><tr><td align="left">Longitude</td><td align="left">Longitude of message report (e.g. 17,9125)</td></tr><tr><td align="left">Navigational status</td><td align="left">Navigational status from AIS message if available, e.g.: 'Engaged in fishing', 'Under way using engine', mv.</td></tr><tr><td align="left">ROT</td><td align="left">Rot of turn from AIS message if available</td></tr><tr><td align="left">SOG</td><td align="left">Speed over ground from AIS message if available</td></tr><tr><td align="left">COG</td><td align="left">Course over ground from AIS message if available</td></tr><tr><td align="left">Heading</td><td align="left">Heading from AIS message if available</td></tr><tr><td align="left">IMO</td><td align="left">IMO number of the vessel</td></tr><tr><td align="left">Callsign</td><td align="left">Callsign of the vessel</td></tr><tr><td align="left">Name</td><td align="left">Name of the vessel</td></tr><tr><td align="left">Ship type</td><td align="left">Describes the AIS ship type of this vessel</td></tr><tr><td align="left">Cargo type</td><td align="left">Type of cargo from the AIS message</td></tr><tr><td align="left">Width</td><td align="left">Width of the vessel</td></tr><tr><td align="left">Length</td><td align="left">Lenght of the vessel</td></tr><tr><td align="left">Type of position fixing device</td><td align="left">Type of positional fixing device from the AIS message</td></tr><tr><td align="left">Draught</td><td align="left">Draugth field from AIS message</td></tr><tr><td align="left">Destination</td><td align="left">Destination from AIS message</td></tr><tr><td align="left">ETA</td><td align="left">Estimated Time of Arrival, if available</td></tr><tr><td align="left">Data source type</td><td align="left">Data source type, e.g. AIS</td></tr><tr><td align="left">Size A</td><td align="left">Length from GPS to the bow</td></tr><tr><td align="left">Size B</td><td align="left">Length from GPS to the stern</td></tr><tr><td align="left">Size C</td><td align="left">Length from GPS to starboard side</td></tr><tr><td align="left">Size D</td><td align="left">Length from GPS to port side</td></tr></tbody></table></div></div><br class="table-break"></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="ch01.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="ch01.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="ch01s03.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">Chapter 1. Managing Ship Trajectories (AIS) </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> Tools</td></tr></table></div></body></html>
2 changes: 1 addition & 1 deletion docs/html/ch01s03.html
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>Tools</title><link rel="stylesheet" type="text/css" href="docbook.css"><meta name="generator" content="DocBook XSL Stylesheets Vsnapshot"><link rel="home" href="index.html" title="MobilityDB Workshop"><link rel="up" href="ch01.html" title="Chapter 1. Managing Ship Trajectories (AIS)"><link rel="prev" href="ch01s02.html" title="Data"><link rel="next" href="ch01s04.html" title="Preparing the Database"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">Tools</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="ch01s02.html">Prev</a> </td><th width="60%" align="center">Chapter 1. Managing Ship Trajectories (AIS)</th><td width="20%" align="right"> <a accesskey="n" href="ch01s04.html">Next</a></td></tr></table><hr></div><div class="section"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="idm151"></a>Tools</h2></div></div></div><p>
<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>Tools</title><link rel="stylesheet" type="text/css" href="docbook.css"><meta name="generator" content="DocBook XSL Stylesheets Vsnapshot"><link rel="home" href="index.html" title="MobilityDB Workshop"><link rel="up" href="ch01.html" title="Chapter 1. Managing Ship Trajectories (AIS)"><link rel="prev" href="ch01s02.html" title="Data"><link rel="next" href="ch01s04.html" title="Preparing the Database"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">Tools</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="ch01s02.html">Prev</a> </td><th width="60%" align="center">Chapter 1. Managing Ship Trajectories (AIS)</th><td width="20%" align="right"> <a accesskey="n" href="ch01s04.html">Next</a></td></tr></table><hr></div><div class="section"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="idm150"></a>Tools</h2></div></div></div><p>
The tools used in this module are as follows:
</p><div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "><li class="listitem"><p>MobilityDB, on top of PostgreSQL and PostGIS. Although you can use a docker image, we recommend to install <a class="ulink" href="https://github.com/MobilityDB/MobilityDB" target="_top">MobilityDB</a> on your system, either from binaries or from sources.</p></li><li class="listitem"><p>QGIS</p></li></ul></div><p>
</p></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="ch01s02.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="ch01.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="ch01s04.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">Data </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> Preparing the Database</td></tr></table></div></body></html>
2 changes: 1 addition & 1 deletion docs/html/ch01s04.html
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>Preparing the Database</title><link rel="stylesheet" type="text/css" href="docbook.css"><meta name="generator" content="DocBook XSL Stylesheets Vsnapshot"><link rel="home" href="index.html" title="MobilityDB Workshop"><link rel="up" href="ch01.html" title="Chapter 1. Managing Ship Trajectories (AIS)"><link rel="prev" href="ch01s03.html" title="Tools"><link rel="next" href="ch01s05.html" title="Loading the Data"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">Preparing the Database</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="ch01s03.html">Prev</a> </td><th width="60%" align="center">Chapter 1. Managing Ship Trajectories (AIS)</th><td width="20%" align="right"> <a accesskey="n" href="ch01s05.html">Next</a></td></tr></table><hr></div><div class="section"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="idm160"></a>Preparing the Database</h2></div></div></div><p>
<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>Preparing the Database</title><link rel="stylesheet" type="text/css" href="docbook.css"><meta name="generator" content="DocBook XSL Stylesheets Vsnapshot"><link rel="home" href="index.html" title="MobilityDB Workshop"><link rel="up" href="ch01.html" title="Chapter 1. Managing Ship Trajectories (AIS)"><link rel="prev" href="ch01s03.html" title="Tools"><link rel="next" href="ch01s05.html" title="Loading the Data"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">Preparing the Database</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="ch01s03.html">Prev</a> </td><th width="60%" align="center">Chapter 1. Managing Ship Trajectories (AIS)</th><td width="20%" align="right"> <a accesskey="n" href="ch01s05.html">Next</a></td></tr></table><hr></div><div class="section"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="idm159"></a>Preparing the Database</h2></div></div></div><p>
Create a new database <code class="varname">DanishAIS</code>, then use your SQL editor to create the MobilityDB extension as follows:
</p><pre class="programlisting">
CREATE EXTENSION MobilityDB CASCADE;
Expand Down
Loading

0 comments on commit 6f51499

Please sign in to comment.