In AWIPS Build 4.2, the Satellite Broadcast Network (SBN) is the primary data feed used to support the hydrologic applications. The disposition of data received via the SBN is governed by the /awips/fxa/data/acq_patterns.txt file, which is on the DS1 machine. The acq_patterns.txt file is set up based on an incoming product's WMO header. Products are then sent to specific directories based on the WMO header; a single product can be sent to more than one directory.
In the /awips/fxa/data/localization directory on DS1, there are sub-directories for each AWIPS site. Within each site directory, there are files containing site-specific localization information. The CCC-hydroSiteConfig.txt file contains information that is used to setup the SBN acquisition of data for use by the hydrologic applications. The information in the CCC-hydroSiteConfig.txt file is a follows:
1. The first line contains the listing of all WFOs from which you want to receive SHEF-encoded data. The format of the line is Wxxx Kfo1|Kfo2|...|Kfon, where Kfo1 is the 4 character site identifier that appears in the first line of the SBN product, which is the WMO header. For example, a SHEF-encoded product from the Pittsburgh WFO may have a WMO header of SRUS27 KPIT. If your interested in this product, you'll want to make sure that KPIT is in the Wxxx line of the CCC-hydroSiteConfig.txt file. Because some WFO identifiers are changing with the modernization, you'll want to make sure that both the old and new identifiers are in the line. This line is also used to identify those WFOs from which you want to receive HDP products.
2. The second line contains the listing of all RFCs from which you want to receive SHEF-encoded products. The format is Rxxx Kfc1|Kfc2|...|Kfcn. The logic is similar to the first line.
3. The third linedepending on the area of the country) with a site identifier of KWBC (this has recently been changed for RFC HADS products). The format for this line is RegCode [1-9][1-9]. The numbers within the brackets can be any combination of the numbers 1-9. If you're only interested in one WMO header, then you don't need the brackets, you simply put the appropriate number. Until recently, all RFC HADs products had a WMO header of SRUS71 KWBC. You should see this reflected in the RegCode line for the RFC sites.
4. The next line, or set of lines, is for those METAR-formatted products that you want. The format of the line is www CCC, where the CCC is the first three characters in the METAR collective CCCMTR000. For each CCC that is listed, all the METARs that are appropriate for that specific collective will be triggered from the text database upon receipt and sent to the directory where the METAR-to-SHEF conversion will take place.
The information described above is used as input by the hydro_acq_patterns.txt file (which can be found in the /awips/fxa/data/localization/nationalData directory on DS1). The format of the hydro_acq_patterns.txt file is as follows:
| TEXT | ^SRU[EMSW][1-9]..(Wxxx) | /ispan/hydro |
| TEXT | ^SRUSRegCode.KWBC | /ispan/hydro |
| TEXT | ^FOUS...(Rxxx) | /ispan/hydro |
| TEXT | ^FGUS[57]..(Rxxx) | /ispan/hydro |
| TEXT | ^[AF][BS]US...(Wxxx) | /ispan/hydro |
| TEXT | ^AGUS5..(Rxxx) | /ispan/hydro |
| TEXT | ^AGUS4..(Wxxx) | /ispan/hdp |
The information in the CCC-hydroSiteConfig.txt file is used to fill in information in the appropriate places in the hydro_acq_patterns.txt file. The hydro_acq_patterns.txt file then gets appended to the bottom of the acq_patterns.txt file, which is found in the /awips/fxa/data directory.
The final piece of the SBN ingest is the acq_patterns.txt file, which is found in the /awips/fxa/data directory on DS1. The acq_patterns.txt file acts as a "traffic cop" of sorts, as it defines the destination of the various products. The definition is done by WMO header, and WMO headers can be directed to more than one location. At the end of each line is a directory path, where the data will be placed. These directory paths are all relative to the /data/fxa directory.
At the bottom of the acq_patterns.txt file is the section for the hydro data. All SHEF data are directed to "/ispan/hydro", which is the /data/fxa/ispan/hydro directory. Similarly, the HDPs are directed to the "/ispan/hdp" directory. We have changed the .Apps-defaults file to point the SHEF decoder at the /data/fxa/ispan/hydro directory (SHEF_DATA_DIR token). This version of AWIPS also includes a hdp/dpa decoder which acts similarly to the SHEF decoder. It is pointed at the /data/fxa/ispan/hdp directory (HDP_PROD_DIR token).
The acq_patterns.txt file can be directly modified to add/edit/delete WMO headers. Two caveats, though: