Amatyr - GitLite

KO | EN

gitlite — search

#hacktoberfest #react #ai #typescript #llm #rust #deep-learning #docker #java #windows #cli #vue #pytorch #openai

Amatyr

(★ 137)

Amateur weather graphs using d3 js, watch js, rivets js, lua, postgresql, nginx

File Explorer

Download Latest Version (.zip)

- config.json.dist
- davislogparser.py
- monitor.py
- wdparser.py
- weewx-2.1.1.postgresql.patch
- - cal-heatmap.css
  - cal-heatmap.js
- - amatyr.js
  - amatyrlib.js
  - d3.v3.min.js
  - drawbars.js
  - drawline.js
  - path.min.js
  - rivets.min.js
  - sparkline.js
  - temprain.js
  - timelinegraph.js
  - watch.js
  - windrose.js
- favicon.png
- pattern.png
- screen.css
.gitignore
amatyr.lua
amatyr.sql
api.lua
cam.html
dashbar.html
Dockerfile
index.html
LICENSE.txt
nginx.conf
pgrouter.lua
README.md
template.lua
tir.lua
tweetyr.py

# Installation Guide

1. Get the code

git clone https://github.com/torhve/Amatyr

Downloads the entire project code from GitHub to your computer.

cd Amatyr

Moves into the project folder you just downloaded.

2. Docker

Easy Recommended

Prerequisites

Git Needed to download the project code from GitHub.
Docker Desktop Needed to build and run containers. Install it and keep it running in the background.

docker build -t amatyr .

Builds a runnable image based on the Dockerfile.

docker run -p 8080:80 amatyr

Runs the built image as an actual container.

✅ Run docker compose ps to check the containers are Up. If the README mentions a port, open http://localhost:PORT in your browser.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# AmatYr

AmatYr is a personal weather station display software project.

The software is a modern HTML5 "single page app" using JavaScript to fetch data from SQL via JSON from Postgresql + Lua backend. Then the data is transformed into pretty visualizations by the brilliant (D3.js)[http://d3js.org] library, giving the data life!

Primary goal of the project is bringing modern and responsive design, suitable for desktop, tablet and mobile-sized screens. A secondary goal is just playing with new technology because it's fun :-) And I guess a goal is to display some pretty graphs and such for local weather!

### Frontend Components

-    D3 js
-    jQuery
-    Rivets js
-    Watch js
-    Path js 
-    Wind rose chart from [Windhistory.com](http://windhistory.com/about.html)
-    Bootstrap css + js
-    Cal-Heatpmap from Wan Qi Chen <http://kamisama.github.io/cal-heatmap/>

### Backend Components

-   Openresty (nginx + luajit)
-   PostgreSQL

### Getting weather data into SQL

The frontend is somewhat loosely coupled with the backend, but it fetches data via JSON from the backend, so to get data displayed it must be accessible in that manner. There's 3 different ways to achieve that. Use one of these methods:

-    Included with the project is a small python utility to read Davis Vantage .txt-logs and insert into SQL (davislogparser.py)
-    Inlucded with the project is a smal python utility to read the output from Weather Display Live and insert into SQL (wdparser.py)
-    Included is a patch (scripts/weewx-2.1.1.postgresql.patch) for (Weewx)[http://weewx.com] to be able to store data in PostgreSQL.

### Installation of the frontend

1. Clone this repostory
1. Add bootstrap resources
1. Add fontawesome resources
1. Compile and install openresty, with LuaJit and Postgresql support.
    Grab source at [Openresty](http://openresty.org)

Run:

./configure --with-luajit  --with-http_addition_module --with-http_dav_module --with-http_geoip_module --with-http_gzip_static_module --with-http_image_filter_module --with-http_realip_module --with-http_stub_status_module --with-http_ssl_module --with-http_sub_module --with-http_xslt_module --with-ipv6 --with-http_postgres_module

And follow Openresty's own installation docs.

1. Configure postgresql
1. Configure the virtual host for nginx like this:

lua_package_path '/home/yr/amatyr/?.lua;;';

server {
        listen	*:80;
        server_name  yr.no;

set $root /home/yr/amatyr/;
        root   $root;
        access_log /home/yr/amatyr/access.log;
        error_log /home/yr/amatyr/error.log;

location /api {
           lua_code_cache off;
           content_by_lua_file $root/pgrouter.lua;
        }
        location /static {
            root $root;
        }

location / { try_files $uri @lua; }
        location @lua {
           lua_code_cache off;
           content_by_lua_file $root/amatyr.lua;
        }
    }

1. Install the resty postgresql driver from <https://github.com/azurewang/lua-resty-postgres>
    One simple way to do this is put the postgres.lua in the default openresty folder:

wget -O /usr/local/openresty/lualib/resty/postgres.lua  https://github.com/azurewang/lua-resty-postgres/raw/master/lib/resty/postgres.lua

### Live demo

My personal installation of this project is running at <http://yr.hveem.no>
It has a blog post to go with the setup at <http://hveem.no/raspberry-pi-davis-vue-weather-station-with-custom-frontend>

### License

AmatYr uses a BSD 3-clause license.

Copyright (c) 2013, Tor Hveem or Project Contributors.
    All rights reserved.

Redistribution and use in source and binary forms, with or without
    modification, are permitted provided that the following conditions are
    met:

* Redistributions of source code must retain the above copyright
      notice, this list of conditions and the following disclaimer.

* Redistributions in binary form must reproduce the above copyright
      notice, this list of conditions and the following disclaimer in the
      documentation and/or other materials provided with the distribution.

* Neither the name of the AmatYr Project, Tor Hveem, nor the names
      of its contributors may be used to endorse or promote products
      derived from this software without specific prior written
      permission.

THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS
    IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO,
    THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
    PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR
    CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
    EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
    PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
    PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
    LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
    NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
    SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.