Agricultural Weather API

Description

This project is to support the UW-Extension's Agricultural Weather Service. Included are the tools to load weather and insolation data from remote sources, calculate and store daily evapotranspiration data, calculate multiple formulas of degreee days, generate and save state-wide maps to display this data, and provide access to all of this information through public endpoints.

Dependencies

Ruby

# install rbenv
sudo apt -y install rbenv

# install ruby-build
mkdir -p "$(rbenv root)"/plugins
git clone https://github.com/rbenv/ruby-build.git "$(rbenv root)"/plugins/ruby-build

# or update ruby-build if already installed
git -C "$(rbenv root)"/plugins/ruby-build pull

# may need to force git to use https
# per https://stackoverflow.com/questions/70663523/the-unauthenticated-git-protocol-on-port-9418-is-no-longer-supported
git config --global url."https://github.com/".insteadOf git://github.com/

# install ruby with rbenv
rbenv install 3.3.0 # or latest version

# update bundler to latest
gem install bundler

Postgres 15 and gem pg

# install postgres
sudo apt -y install postgresql-15 postgresql-client-15 libpq-dev
sudo service postgresql start

# install gem pg
gem install pg

# Set postgres user password to 'password'
sudo su - postgres
psql -c "alter user postgres with password 'password'"
exit

Python and eccodes for weather data GRIB files

sudo apt -y install python3 python3-pip libeccodes-tools
pip install ecCodes
grib_get_data # confirm it works

gnuplot and imagemagick for map image creation

sudo apt -y install gnuplot-qt
gnuplot # confirm it works

sudo apt -y install imagemagick-6.q16
composite # confirm it works

Setup

1. Ensure dependencies above are satisfied
2. Clone the project
3. Install gems with bundle install in project directory
4. Create database and schema with bundle exec rails db:setup
5. Import and process weather data. By default it will fetch the last 5 days.
   • Open the rails console bundle exec rails c
   • Run all the data scripts with RunTasks.all
   • Exit the rails console with exit
6. Start the server with bundle exec rails s
7. Server will be listening on localhost:8080

Running Tests

Lint

# check code for style before commit
bundle exec standardrb --fix

RSpec

bundle exec rspec

API Documentation

bundle exec rake dredd RAILS_ENV=test

Deployment

Work with db admin to authorize your ssh key for the deploy user. Confirm you can access the dev and production servers:

• ssh deploy@dev.agweather.cals.wisc.edu -p 216
• ssh deploy@agweather.cals.wisc.edu -p 216

Then run the following commands from the main branch to deploy:

• Staging: cap staging deploy
• Production: cap production deploy

Endpoints

Endpoints are summarized in our API Blueprint file.