Skip to content

M-E-E-R-e-V/mwpa

Repository files navigation

NOTE: This document is under development. Please check regularly for updates!

MWPA

MWPA

Mammal watching. Processing. Analysing.

Processing and analysing data gathered by mammal watching.

Gitter LGTM Alerts LGTM Grade License: GPL v3.0 Liberapay

MWPA provides the acquisition of scientific observational data, an easy-to-use user interface for viewing, confirming and reviewing the data. This includes the backend for data collection, the frontend and a mobile phone app for snycronization. The recorded ones relate to mammals and their observations. The aim is to record the observations cleanly and quickly. For this purpose, the old data is processed again and imported.

collect data

You can also access the dev chatroom on our Gitter Channel.

Index

  1. Motivation
  2. Help the project
  3. About MWPA
  4. Getting Started
  5. Project supervisor
  6. License

Motivation

When I started my trip with the M.E.E.R e.V. association, I got to know the scientific work on La Gomera. It was overwhelmed to get so close to the marine mammals (adventure). I recognized the value of this work. The association M.E.E.R e.V. has dedicated itself to the promotion of environmental protection, science and education, in particular the protection of the cetaceans (whales and dolphins) and their marine habitat as well as the research of the cetaceans off La Gomera (Canary Islands). Working with the people was wonderful and important. I was asked whether we could do something and because of the old software for collecting the data. After a long time passed by the pandemic, we finally got back to the topic. I would like to take on this task on a voluntary basis to the best of my ability and time. :)

M.E.E.R e.V.

Help the project

  • help the association M.E.E.R e.V.
  • you can program, you have ideas, then help us here, foke us and improve the code :) or write to us, we like to listen.
  • how can you still help?

About MWPA

MWPA is an NodeJs backend application for data collection and with frontend web application for easy-to-use. The backend will exchange the data with the frontend via a rest-json API. The mobile app can synchronize the data via another rest-json API with the backend.

1. About Backend

  • User administration
  • Data properties management (specifications, management, ... and much more)
  • Data collection and analysis
  • Export for scientific programs
  • Import old data
  • API management for Mobile App

Importer Verions

  • IM2020: Import file 2020 is a prepared file with fixed columns. The import can only be carried out once with this file.

Commandline arguments

See the example for starting the express server.

--config

  • Path to config file

--import

  • Path to IM2020 import file

Backend dependencies

Database documentation

MWPA Database documentation on dbdiagram.io

API documentation

MWPA API documentation on stoplight.io

2. About Frontend

  • User login
  • Adminsitration
  • Lists viewing/Filtering/Data editing

Frontend dependencies

Screenshots

1

3. About Mobile App

  • Collecting data (also Offline)
  • Sync to backend

More can read here

Getting Started

All information for the installation and configuration can be found in the MWPA wiki.

Project supervisor

License

License: GPL v3.0

This project is licensed under the GNU General Public License v3.0. See the LICENSE file for details.