3.2 Pi-Service
An excellent forecast, run on an efficient system, is only helpful if it is used. The Published Interface Service, or Pi-Service, extracts data from the databases in CHPS, making it available for use by other applications.
Data Exchange
Pi-Service is a data exchange format – one of many CHPS utilizes. One of the ways Pi-Service exchanges data is by taking the data from its native format and converting it into something CHPS can use.
Client Setup
Pi-Service 1) extracts the data, and 2) another program picks up the Pi-Service information, transforms it, and 3) sends it to the WFOs. Pi-Service can also trigger workflows.
In order to set up a Pi-Service client, you must have an Operator Client (OC) or a Stand Alone (SA), know the number of the port to which you are listening, and configure a FewsPiServiceConfig file for the OC or SA instance.
The CHPS System Manager module outlined the steps in setting up the directory structure for Pi-Service and editing the script. Click here for a refresher.
One of the uses of Pi-Service is pushing model states to a WFO’s Site Specific Headwater Predictor (SSHP).
Configure the service by defining:
- the type of data you are sending to the office,
- the locations for which the data is sent,
- and the directory to which the data is being pushed.
You must complete configuration changes before running the fews_piservice.sh script! The script requires guidelines on where to look for data and where to put it. Be sure the script output location is correct!
Once the configuration changes are complete, the SSHP data transfer is transparent to the WFO and RFC.
Use the following job sheet to help you configure Pi-Service.
Job Sheet: Configuring Pi-Service
Instructions: Click here to display regular course navigations once you have clicked on each link.