VIPSLogic user guide
Tor-Einar Skog, NIBIO plant health
Version: 2015-07-19
VIPSLogic is the system that ties all the parts of the VIPS system together. The VIPS system design is illustrated below. VIPSLogic main parts are:
•Storing information about weather stations and locations
•Running prognosis calculations at regular intervals
•Store the results from the calculations, and make them available to clients
From the admin menu, select “Weather stations”
Then, select “Add new”
Fill in the form as shown below.
In order to get the correct coordinates for the station, you can zoom and pan the map and click on it. The coordinates will be added automatically to the form.
After clicking submit, the weather station is visible on the overview of weather stations
It's possible to connect external forecasting to the weather station. For the moment, the only supported external resource is RIMPro (http://www.rimpro.eu/), but new types of resources may be easily added. So, for example, if you have one or more RIMPro forecasts using weather data from one of your weather stations, you can add that to the weather station form, by using the unique identifier for your station in RIMPro (see RIMPro for how to find it). For instance:
When looking at the weather station using VIPSWeb, the RIMPro resource is automatically made available, see the screen shot below
First, select “Forecasts” from the administration menu
Then click “Add new”.
Fill in the form, as illustrated below
When you hit “Submit”, you're redirected to the list of all your configured forecasts. If the current date is within the range of your entered “Date start” and “Date end”, VIPSLogic will automatically start running the calculation for this forecast. This is normally done every hour.
The forecast results are available in their basic form as JSON values from VIPSLogic. In order to view the results from a particular forecast, use this URL: http://logic.vips.nibio.no/rest/forecastresults/[FORECASTCONFIGURATIONID] , where FORECASTCONFIGURATIONID is the number identifying a particular forecast configuration in VIPSLogic. This ID can be obtained by opening the form for a particular forecast (see illustration below).
The ID is then applied to the URL in the browser, e.g. http://logic.vips.nibio.no/rest/forecastresults/88 , and the results are returned in JSON format, which looks something like this (each model differs a bit):
[{"forecastResultId":572069572,"resultValidTime":1420066800000,"warningStatus":2,"forecastConfigurationId":88,"keys":["WEATHER.TMDD4C","DELIARADIC.TMDD4CUT","DELIARADIC.TJM10DD4CLT","WEATHER.TMD","WEATHER.TJM10D","DELIARADIC.TMDD4CLT","WEATHER.TJM10DD4C","DELIARADIC.TJM10DD4CUT"],"allValues":{"WEATHER.TMDD4C":"0.35","DELIARADIC.TMDD4CUT":"210","DELIARADIC.TJM10DD4CLT":"140","WEATHER.TMD":"4.35","WEATHER.TJM10D":"2.84","DELIARADIC.TMDD4CLT":"185","WEATHER.TJM10DD4C":"0","DELIARADIC.TJM10DD4CUT":"160"}},{"forecastResultId":572069573,"resultValidTime":1420153200000,"warningStatus":2,"forecastConfigurationId":88,"keys":["WEATHER.TMDD4C","DELIARADIC.TMDD4CUT","DELIARADIC.TJM10DD4CLT","WEATHER.TMD","WEATHER.TJM10D","DELIARADIC.TMDD4CLT","WEATHER.TJM10DD4C","DELIARADIC.TJM10DD4CUT"],"allValues":{"WEATHER.TMDD4C":"1.77","DELIARADIC.TMDD4CUT":"210","DELIARADIC.TJM10DD4CLT":"140","WEATHER.TMD":"5.41","WEATHER.TJM10D":"3.6","DELIARADIC.TMDD4CLT":"185","WEATHER.TJM10DD4C":"0","DELIARADIC.TJM10DD4CUT":"160"}},{"forecastResultId":572069574,"resultValidTime":1420239600000,"warningStatus":2,"forecastConfigurationId":88,"keys":["WEATHER.TMDD4C","DELIARADIC.TMDD4CUT","DELIARADIC.TJM10DD4CLT","WEATHER.TMD","WEATHER.TJM10D","DELIARADIC.TMDD4CLT","WEATHER.TJM10DD4C","DELIARADIC.TJM10DD4CUT"],"allValues":{"WEATHER.TMDD4C":"1.77","DELIARADIC.TMDD4CUT":"210","DELIARADIC.TJM10DD4CLT":"140","WEATHER.TMD":"3.67","WEATHER.TJM10D":"3.63","DELIARADIC.TMDD4CLT":"185","WEATHER.TJM10DD4C":"0","DELIARADIC.TJM10DD4CUT":"160"}},{"forecastResultId":572069575,"resultValidTime":1420326000000,"warningStatus":2,"forecastConfigurationId":88,"keys":["WEATHER.TMDD4C","DELIARADIC.TMDD4CUT","DELIARADIC.TJM10DD4CLT","WEATHER.TMD","WEATHER.TJM10D","DELIARADIC.TMDD4CLT","WEATHER.TJM10DD4C","DELIARADIC.TJM10DD4CUT"],"allValues":{"WEATHER.TMDD4C":"1.77","DELIARADIC.TMDD4CUT":"210","DELIARADIC.TJM10DD4CLT":"140","WEATHER.TMD":"2.59","WEATHER.TJM10D":"3.22","DELIARADIC.TMDD4CLT":"185","WEATHER.TJM10DD4C":"0","DELIARADIC.TJM10DD4CUT":"160"}},{"forecastResultId":572069576,"resultValidTime":1420412400000,"warningStatus":2,"forecastConfigurationId":88,"keys":["WEATHER.TMDD4C","DELIARADIC.TMDD4CUT","DELIARADIC.TJM10DD4CLT","WEATHER.TMD","WEATHER.TJM10D","DELIARADIC.TMDD4CLT","WEATHER.TJM10DD4C","DELIARADIC.TJM10DD4CUT"],"allValues":{"WEATHER.TMDD4C":"1.77","DELIARADIC.TMDD4CUT":"210","DELIARADIC.TJM10DD4CLT":"140","WEATHER.TMD":"1.21","WEATHER.TJM10D":"2.87","DELIARADIC.TMDD4CLT":"185","WEATHER.TJM10DD4C":"0","DELIARADIC.TJM10DD4CUT":"160"}}]
These data may either be imported to a spreadsheet, or transformed into more human readable formats by a programming language of some sort, like JavaScript, Java, C#, Python etc.
Bioforsk has created a web page application called VIPSWeb, which is Open Source and available for download and installation for everyone. This web page has a default detail view of a forecast, with this basic URL: http://[SERVERNAME]/forecasts/[FORECASTID]/ . FORECASTID is the same number as mentioned in the previous paragraph, ie. the number in VIPSLogic that identifies this exact forecast. For the time being, all forecasts are available from all installations of VIPSWeb, so by using our test installation located at http://vipsweb.vips3test.nibio.no/ , you can view the forecast details from e.g. this URL: http://vipsweb.vips3test.bioforsk.no/forecasts/88/
If the forecast doesn't seem to be running, the first thing to check is the scheduling system. Select “Scheduling” from the top menu. In the lower part of the page, you see today's history for each batch operation. The job to look for is called “Run all forecast configurations”, and if it says “Failed partly” or “Failed completely” then there's surely something wrong with at least one forecast. Click “Details” and you will see something like this illustration below:
If you find your forecast in this list, then something has gone wrong. In some cases the error messages are easy to read, and in other cases they're not. In any way, contact the VIPS support team if it's not obvious that something is wrong with the weather data or some other factor on your side.