What VMStools can do for you
Vmstools is an open-source software package build in R. It is specifically developed to process, analyse and visualize logbooks and VMS data.
Some of its functionality:
- Analyses use standardised data formats for logbook (EFLALO) and VMS (TACSAT)
- Handles erroneous data point detection and removal
- Métier identification through the use of clustering techniques
- Link logbook and VMS data together in order to distinguish fishing from other activities
- Provide high-resolution maps of both fishing effort and -landings, interpolate vessel tracks
- Calculate indicators of fishing impact as listed under the Data Collection Framework at different spatio-temporal scales.
- Prepare data for FishFrame submission
- Link other spatial data to VMS and logbook data
We've written many wiki's to help new users find their way around in VMStools. In addition, all functions embedded in VMStools also have a help-page that can be accessed from within R. You can find the wiki pages here.
You may download the pre-compiled VMStools package (and other useful information) here
Installing the VMStools package
Download the VMStools zip or rar file from the repository under the release tab or build it yourself from the repository. Please note that the VMStools package depends on a number of other R packages. They are listed in the DESCRIPTION file in vmstools/ of the repository. The packages VMStools depends on can easily be installed through:
vmstoolsPackages <- c("cluster","data.table","doBy","maps","mapdata","maptools","PBSmapping","sp") for(i in vmstoolsPackages) try(install.packages(pkgs=i,repos=getOption("repos"))) Once you've installed all secondary packages install VMStools using install.packages("yourPath/vmstools.zip")
You will need the following software to use the VMStools software and repository.
- R (version 3.x.x) for your system (still support for R2.14.x as well). Available here.
- The VMStools package itself, available for download here
- For very enthusiastic users / developers: For Windows users, we recommend TortoiseGit. Linux users will typically have access to such a client through their package distribution system.
- Some way to write and edit R code. For Windows, try RStudio or Tinn-R. For Linux, you almost certaintly already have Vi
Getting the Code for enthusiastic users / developers
Once you've got all the necessary bits and pieces, the next step is to fetch a "working copy" of the VMStools repository from the server. The SVN client that you have installed takes care of this. The general process is client specific, but generally involves two steps
- Create a directory for your working copy (e.g. Desktop/VMStools) and
- "Checking out" the repository.
We'll assume you can handle 1 and 2. yourself, but number 3. is a bit trickier, and is of course dependent on your SVN client. There are a number of good resources available e.g. for windows
To download the source code, checkout the repository from https://github.com/nielshintzen/vmstools/tree/master/vmstools/. It will not be possible to commit your changes - however, contact us if you'd like to commit changes too.