CROW is a single-page application to visualize birds detected by weather radars. It visualizes vpts data from a public repository directly in the browser and can thus be hosted on a static file server. As it only visualizes data from one radar at a time, it is easily scalable.
CROW is implemented in TypeScript and makes use of Vue 3, Vite, D3 and BootstrapVueNext.
CROW was jointly developed by the Research Institute for Nature and Forest (INBO) and the Royal Meteorological Institute of Belgium (RMI) in collaboration with the Royal Belgian Institute for Natural Sciences (RBINS), with financial support from the Belgian Science Policy Office (BelSPO valorisation project CROW).
The application can be cited as:
Noé N, Reyniers M, Van Hoey S, Desmet P (2021) CROW - Online tool to visualize birds detected by weather radars. http://doi.org/10.5281/zenodo.4629449
Install with:
npm install
Update dependencies regularly (minor and patch versions, within the ranges in package.json) with:
npm update
Major versions are upgraded deliberately, one package at a time, as they can require code changes:
npx npm-check-updates # Show outdated dependencies, majors included
npx npm-check-updates -i # Pick which ones to upgrade
Dependabot only opens security update PRs, grouped into one (see .github/dependabot.yml). Updating the lockfile yourself (npm update or npm audit fix) closes them automatically.
Run build, lint and unit tests after any update.
Run in development with:
npm run serve
Run unit tests with:
npm run test:unit
Build with:
npm run build
There is no need to build manually, as this is done automatically by GitHub Actions for every commit pushed to the main branch. It will serve the site at https://inbo.github.io/crow/.
If the app is to be deployed under a URL prefix (for example https://inbo.github.io/crow), create a env.local file in the source tree root with content: URL_PREFIX = "/crow/".
See src/README.md.