Difference between revisions of "Sprinkler/Help"
(→Test) |
|||
| (19 intermediate revisions by the same user not shown) | |||
| Line 1: | Line 1: | ||
| + | This is the Manual/Help Page for the {{Link|target=Sprinkler}} software. | ||
= Prerequisites = | = Prerequisites = | ||
* [http://www.oracle.com/technetwork/java/javase/downloads/jre8-downloads-2133155.html Oracle Java Runtime 8] | * [http://www.oracle.com/technetwork/java/javase/downloads/jre8-downloads-2133155.html Oracle Java Runtime 8] | ||
| Line 11: | Line 12: | ||
= Starting = | = Starting = | ||
Run the software with <nowiki>java -jar sprinkler.jar</nowiki> or <nowiki>sprinkler</nowiki> (If you built the software yourself: <nowiki>cd com.bitplan.sprinkler/release</nowiki> before this command) | Run the software with <nowiki>java -jar sprinkler.jar</nowiki> or <nowiki>sprinkler</nowiki> (If you built the software yourself: <nowiki>cd com.bitplan.sprinkler/release</nowiki> before this command) | ||
| + | = Setup = | ||
| + | == Sprinkler performance == | ||
| + | The system needs to know how much water your sprinkler will apply per hour. | ||
| + | To test this you need: | ||
| + | * a cylindric container - any jar or utensil will do that has a uniform cylindric diameter | ||
| + | * a letter or household scale that can measure to grams | ||
| + | * a ruler | ||
| + | [[File:IMG_2380.JPG|600px]] | ||
| + | |||
| + | Put your container on the lawn and sprinkle for 1/2 hour. | ||
| + | [[File:IMG_2373.JPG|400px]] | ||
| + | |||
| + | You could now measure the water level directly with a ruler. The result will be more precise if you use the scale. | ||
| + | Weigh the container 3 times | ||
| + | # with the amount of water the sprinkler applied in 30 minutes | ||
| + | # empty | ||
| + | # the container full to a set level e.g. 10 cm | ||
| + | |||
| + | In our example we got the results: | ||
| + | # 83 g for the container with amount of water the sprinkler applied in 30 minutes | ||
| + | # 37 g for the empty container | ||
| + | # 750 g for the container full to 10 cm (100 mm) | ||
| + | [[File:SprinkledBucket_IMG_2374.JPG|400px]] | ||
| + | [[File:EmptyBucket_IMG_2376.JPG|400px]] | ||
| + | [[File:Fullbucket_IMG_2379.JPG|400px]] | ||
| + | [[File:Image_Bucket_2377_750g.JPG|400px]] | ||
| + | |||
| + | Now we are interested in what the equivalent of mm rain per hour of this sprinkler is. | ||
| + | To calculate this we can use [http://wiki.bitplan.com/images/wiki/e/e6/SprinklerPerformance.xlsx this excel sheet]. | ||
| + | |||
| + | [[File:SprinklerSheet2018-08-05.png|400px]] | ||
| + | |||
| + | In our example the result is 12.6 mm per hour. Given the size of the lawn the sprinkler covers is 100 square meters this is equivalent to 1260 l of Water per hour. | ||
| + | |||
| + | = Screenshots = | ||
| + | == current Weather == | ||
| + | [[File:Weather_current Weather.png]] | ||
| + | == Weather Forecast == | ||
| + | The weather forecast screen shows the rain forecast for your location from the [https://openweathermap.org/ openweathermap.org] as a block diagram with 3 h blocks for the next 5 days. | ||
| + | [[File:Weather_Weather Forecast.png]] | ||
| + | |||
| + | == Location settings == | ||
| + | You can lookup your location by name if you enter the name and Country code of your location and erase the id field. The id, longitude and lattitude will then be automatically looked up from | ||
| + | the openweathermap.org location list. | ||
| + | [[File:Preferences_Location.png]] | ||
| + | |||
| + | == Sprinkler settings == | ||
| + | [[File:Preferences_Settings.png]] | ||
= Downloads = | = Downloads = | ||
| Line 17: | Line 66: | ||
= Build = | = Build = | ||
| + | <source lang='bash'> | ||
| + | git clone https://github.com/BITPlan/com.bitplan.sprinkler | ||
| + | cd com.bitplan.sprinkler | ||
| + | mvn install -D skipTests | ||
| + | </source> | ||
| + | = Test = | ||
| + | <source lang='bash'> | ||
| + | cd com.bitplan.sprinkler | ||
| + | mvn test | ||
| + | </source> | ||
| + | [[Category:frontend]] | ||
Latest revision as of 16:05, 21 August 2018
This is the Manual/Help Page for the Sprinkler software.
Prerequisites
or if you'd like to build the Sprinkler software yourself:
Installation
Download the software for your platform from #Downloads or build the software yourself
Starting
Run the software with java -jar sprinkler.jar or sprinkler (If you built the software yourself: cd com.bitplan.sprinkler/release before this command)
Setup
Sprinkler performance
The system needs to know how much water your sprinkler will apply per hour. To test this you need:
- a cylindric container - any jar or utensil will do that has a uniform cylindric diameter
- a letter or household scale that can measure to grams
- a ruler
Put your container on the lawn and sprinkle for 1/2 hour.
You could now measure the water level directly with a ruler. The result will be more precise if you use the scale. Weigh the container 3 times
- with the amount of water the sprinkler applied in 30 minutes
- empty
- the container full to a set level e.g. 10 cm
In our example we got the results:
- 83 g for the container with amount of water the sprinkler applied in 30 minutes
- 37 g for the empty container
- 750 g for the container full to 10 cm (100 mm)
Now we are interested in what the equivalent of mm rain per hour of this sprinkler is. To calculate this we can use this excel sheet.
In our example the result is 12.6 mm per hour. Given the size of the lawn the sprinkler covers is 100 square meters this is equivalent to 1260 l of Water per hour.
Screenshots
current Weather
Weather Forecast
The weather forecast screen shows the rain forecast for your location from the openweathermap.org as a block diagram with 3 h blocks for the next 5 days.
Location settings
You can lookup your location by name if you enter the name and Country code of your location and erase the id field. The id, longitude and lattitude will then be automatically looked up from
the openweathermap.org location list.
Sprinkler settings
Downloads
- sprinkler.jar - multiplatform Java
- sprinkler.exe - Windows executable
Build
git clone https://github.com/BITPlan/com.bitplan.sprinkler
cd com.bitplan.sprinkler
mvn install -D skipTests
Test
cd com.bitplan.sprinkler
mvn test