The World Area Forecast System (WAFS) Internet File Service (WIFS)
Users Guide
By
WAFC Washington
Version 7.0
February 2024
Document Change History
Note: Any section, image or table that's been added or updated from the last version release will have a blue background color.
Date | Version | Description1 |
---|---|---|
24-Feb-10 | 1.0 | Initial draft release. |
26-Mar-10 | 1.1 | Incorporated user feedback including: new document change history section, correction to Table 2 GRIB/GRIB2 description, additional descriptions where necessary, section heading changes, and more. |
30-Mar-10 | 1.2 | Based on feedback from reviewers, made some changes to the User Authentication fields. |
5-Apr-10 | 1.2 | Based on feedback from reviewers, added “WAFC Washington” wording to title, footer, and the Introduction. |
26-Apr-10 | 1.2 | Based on feedback from reviewers: (1) section 2 was renamed “Service Overview and Responsibilities of U.S. Government Agencies”, (2) section 3 was renamed “Data Retrieval Process”, (3) backup information was added to section 4, (4) section 7 “Responsibilities of U.S. Government Agencies” was renamed “WIFS Customer Support” and is now section 8, and (5) more information was added to the WIFS Customer Support section including information on a trouble ticket system. |
20-May-10 | 1.3 | Based on technical interchange with customers, the GRIB data is now being served in a concatenated file format. The description of the file formats in Section 6 reflects this change. Based on feedback from reviewers: (1) Appendix A was added to describe the GNU wget utility, (2) Section 3 was modified to include a reference for Appendix, (3) minor changes were made in Section 4 to clarify back-up roles and responsibilities, and (4) Section 4.2 title was modified. |
15-Jul-10 | 2.0 | Folded in the contents of the WIFS Interface Control Document; added Appendix B, Reference Documents; expanded the GNU wget description in Appendix A; updated Section 3 Data Retrieval Process; added Appendix C WIFS Registration; changed link to software providers in Section 3; reorganized Section 4 based on reviewer comments; added new Section 4.3 Suspension of Access; added note to Section 5 that mentions potential harmonization of directory structures. |
26-Aug-10 | 2.1 | Changed WIFS help desk phone number. |
1-Nov-10 | 3.0 | Completed Draft Interim Version: Added introductory information Reorder sections for logical flow Added Chapter 2, WIFS Products and Data |
4-Jan-11 | 3.1 | Added verbiage on authorization criteria. Updated document after review of v3.0. |
14-Jan-11 | 4.0 | Document baselined after final reviews. |
28-Mar-11 | 4.1 | Modified Section 5 Data Retrieval Process to make it clearer and easier to interpret; this includes removing the site-specific URLs. Added reference to SADIS User Guide Annexes 1 and 4. |
4-Dec-17 | 5.0 | Removed any mention of GRIB1 data; changed all mention of “trial” forecast data to “harmonized” data, added expected data availability tables to Section 3; removed trial forecast designation for WIFS aviation grids; modified the directory structure in Section 6; modified Appendix A to include more information about how a user can use WIFS; moved GNU wget information to Appendix B. Added GRIB2 details to Appendix C. FL080 (750 hPa), FL210 (450 hPa) and FL480 (125hPa) were included in the Appendix C table for wind, temperature, RH, and height. Added sections on SIGWX and PNG corrections. |
14-Apr-22 | 6.0 | Changed Help Desk work hours from 7am-3:30pm to 7am to 3pm. Updated Appendix C, WIFS directory structure (fig. 6.1) to include 0.25 data, figure 6.3. Added section 6.2.2 |
4-Feb-24 | 7.0 | Updated directory listings to show 0.25 deg data. Added links to API documentation where needed Added IWXXM data information Changed password update information |
1 Minor corrections and cosmetic changes are not recorded
Table of Contents
1.1.1. International Standards
2. Service Overview and Responsibilities of U.S. Government Agencies
3. Products and Data Available on WIFS
3.4. Significant Weather BUFR Files
3.6. OPMET IWXXM Data 3.8. Sources of WIFS Information Content 4.3. Determining Operational and Backup Service Use 6. WIFS Directory Structure and File Formats 6.2.1. Format of Gridded Files 6.2.2. Format of 0.25 Degree Gridded Hazard Files 6.3. OPMET Alphanueric Data Files 6.6.1. Format of Administrative Message Files 6.7. Announcing Changes in Services or Products 9. User Troubleshooting Guidelines Appendix C. WAFS Upper Air GRIB2 Details Table 3-1 GRIB 2 Data Availability Table 3-2 SIGWX PNG Data Availability Table 3-3 BUFR Data Availability Table 3-4 Administrative Message Types Table 6-1 Significant Weather PNG Files Table 9-1 Troubleshooting Guidelines Figure 2-1 WIFS and SADIS Area Designations Figure 4-1 WIFS Registration Form Figure 6-1 WIFS Directory Structure Figure 6-2 Snapshot of the BUFR folder Figure 6-3 Snapshot of the GRIB2 folder Figure 6-3.1 Pre-Set Map Areas Figure 6-3.2 0.25 Degree Hazard File Snapshot Figure 6-4 Snapshot of the OPMET-HOURLY Folder Figure 6-5 Snapshot of the OPMET-MINUTE folder Figure 6-6 Snapshot of the OPMET-ROLLING folder Figure 6-7 Snapshot of the IWXXM Folder Figure 6-8 Snapshot of the IWXXM MINUTE folder Figure 6-10 Snapshot of the PNG SIGWX KWBC folder Figure 6-11 Snapshot of the PNG VOLC folder Figure 6-12 Snapshot of the ADMIN_MSGS folder The International Civil Aviation Organization (ICAO) established the World Area Forecast System (WAFS) system in 1982 to supply meteorological authorities and other users with global forecasts of en-route meteorological conditions in digital form. The U.S. and the United Kingdom (UK) share in the global distribution of the WAFS forecasts required in ICAO Annex 3 and the operational meteorological (OPMET) information specified in the Facilities and Services Implementation Document (FASID) Table MET2A. The U.S. distribution of WAFS forecasts and OPMET information is provided through the WAFS Internet File Service (WIFS). The UK distribution is provided through systems managed by the Secure Aviation Data Information Service (SADIS) program; formerly known as the Satellite Distribution System. WIFS replaced the International Satellite Communication System (ISCS) and is compliant with ICAO Document 9855, Guidelines on the Use of the Public Internet for Aeronautical Applications. The U.S. WAFS forecasts are provided by the Washington World Area Forecast Center (WAFC). The Washington WAFC is operated by the United States National Weather Service (NWS). Through access to WIFS, States may wish to meet their obligation under Article 28 of the Convention on International Civil Aviation regarding the provision of meteorological services to facilitate international air navigation. Regarding the use of WAFS products, for example, ICAO Annex 3 specifically notes in Appendix 2, Section 2.1.1: “Aerodrome meteorological offices shall use WAFS forecasts issued by the WAFCs in the preparation of flight documentation, whenever these forecasts cover the intended flight path in respect of time, altitude and geographical extent, unless otherwise agreed between the meteorological authority and the operator concerned.” WIFS provides access to authorized users as described in Section 4. WIFS is a real-time data repository of all OPMET data and WAFS products that are accessible via the Internet to authorized users. The provisions for requesting and approving user access are described in Section 4. The FAA, as the U.S. Meteorological Authority, identifies the ICAO requirements for the products and services to be provided by the Washington WAFC. The National Oceanic and Atmospheric Administration (NOAA) NWS is the service provider of WAFS products and has agreed to manage and operate WIFS. WIFS hosts the WAFS products and OPMET data on file servers on multiple geographically diverse web farms. This provides redundancy in case of a networking or system failure. If the primary farm goes down, users will be transparently moved to another farm. For timestamp consistency, only one farm is active at any time. WIFS and SADIS also provide mutual backup support should there be a failure of either service or failure of user access to either service (see Figure 2-1 to determine areas designated primary for WIFS and SADIS). Section 4.3 describes the criteria for determining operational use and establishing backup service. WIFS provides access to WAFS products and OPMET data as defined in ICAO Annex 3, Meteorological Service for International Air Navigation, Chapter 3. These products are provided as follows: Note: Starting in February 2024, new 0.25 degree grids are available via the WIFS API with 56 vertical levels up to FL600 and 39 forecast times out to T+120. These grids are not available on the legacy WIFS data pages. See the WIFS API page for more details on how to access these new grids. WIFS provides upper-air gridded forecasts in GRIB2 format including WAFC Washington/WAFC London harmonized forecasts of cumulonimbus (CB) clouds, turbulence (clear air), and icing. Users retrieving this data must have a data processing system, such as the WAFS workstation, which can read, decode, and display the data. Detailed information concerning upper-air gridded forecasts can be found in ICAO Annex 3, Appendix 2. Specific information related to WIFS gridded data can be found in Section 6.2 and Appendix C. WAFS Upper Air GRIB2 Details. Use Table 3-1 to determine when to expect data to be available. Table 3-1 GRIB 2 Data AvailabilityList of Tables
List of Figures
1 Introduction
1.1 Reference Documents
1.1.1 International Standards
1.1.2 Industry Standards
1.1.3 WAFC London Documents
2 Service Overview and Responsibilities of U.S. Government Agencies
Figure 2-1 WIFS and SADIS Area Designations3 Products and Data Available on WIFS
3.1 Overview of Service
3.2 Grid Point Data
Model Time (UTC) | Upper-Air Availability (UTC)* | Harmonized Data Availability (UTC)* |
---|---|---|
00 | 0345 | 0435 |
06 | 0945 | 1035 |
12 | 1545 | 1635 |
18 | 2145 | 2235 |
* The expected time under normal conditions. Factors out of our control (such as model delays, network sluggishness and higher than normal system loads) may delay these times by up to 30 minutes.
3.3 PNG Charts
SIGWX forecasts supplied in a Portable Network Graphics (PNG) format are issued four (4) times daily, and are valid at 0000, 0600, 1200, and 1800 UTC for the areas of coverage. The SIGWX forecasts include the elements listed in ICAO Annex 3, Appendix 2, section 1.3.3 (19thedition). Table 3-2 defines the forecast time and the availability of the SIGWX forecasts for use at a fixed schedule.
Table 3-2 SIGWX PNG Data Availability
Forecast Package Time (UTC) | PNG Availability (UTC)* |
---|---|
00 | 0700 |
06 | 1255 |
12 | 1850 |
18 | 0100 |
* The expected time under normal conditions. Factors out of our control (such as model delays, network sluggishness and higher than normal system loads) may delay these times by up to 30 minutes.
NOTE:Corrections of PNG graphics will show up with a “_CCA”, “_CCB”, etc., added to the filename after the center designator as in “20161012_1200_JUFE00_KWBC_CCA.png”.
Volcanic ash and tropical cyclone graphics in PNG format are also available on WIFS. These products do not have a fixed schedule other than once the product is issued there are scheduled updates until the product is canceled. These PNG files contain the letters “PFXD” (volcanic ash) and “PZXD” (tropical cyclone) in the filename.
3.4 Significant Weather BUFR Files
SIGWX forecasts are issued using Binary Universal Form for the Representation of meteorological data (BUFR) code form follow the specifications included in WMO Publication No. 306, Manual on Codes, Volume I.2, Part B – Binary Codes. Forecasts of SIGWX prepared by WAFC Washington are issued four times daily, valid at 0000, 0600, 1200, and 1800 UTC. Table 3-3 defines the forecast time and the schedule of the availability of these files in a BUFR format.
Table 3-3 BUFR Data Availability
Forecast Package Time (UTC) | BUFR Availability (UTC)* |
---|---|
00 | 0700 |
06 | 1255 |
12 | 1850 |
18 | 0100 |
* The expected time under normal conditions. Factors out of our control (such as model delays, network sluggishness and higher than normal system loads) may delay these times by up to 30 minutes.
NOTE:Corrections of PNG graphics will show up with a “_CCA”, “_CCB”, etc., added to the filename after the center designator as in “20161012_1200_JUFE00_KWBC_CCA.bufr”.
BUFR is a standard binary format approved by the WMO for efficient storage of meteorological features. To produce a BUFR file, two elements are needed: a raw data file and a set of tables containing descriptors. When raw data is encoded, each data value is attached to a descriptor defining what the data represents. The decoding process reads the BUFR file, looks up the descriptor in the relevant table, and writes out the information in the proper format. BUFR does not provide information on how to visually represent data. However, the WAFCs have written guidance on representation, which can be found on the WAFS Operations Group web page (https://www.icao.int/airnavigation/METP/MOG/Pages/default.aspx).
BUFR files contain a set of tables with descriptors. Descriptors must be decoded from a set of common tables on the local machine in order to understand what the values represent. To this end, BUFR messages are very small and machine independent. They can be understood and decoded by any BUFR decoder having the latest tables available.
SIGWX data in BUFR format is independent of the background or projection. Only the information describing the feature is encoded. For example, a CLOUD area is a list of points with the height of bases and tops, and cloud type and amount attributes attached. There are no rules on how the cloud area should be drawn, or how the attributes are displayed. On SIGWX charts this is shown as a box, sometimes with an arrow to the area, but this information is determined by the graphical display program.
3.5 OPMET Alphanumeric Data
OPMET information includes Routine Aviation Weather Reports (METARs), Special Aviation Weather Reports (SPECIs), Terminal Aerodrome Forecasts (TAFs), Pilot Reports (PIREPs), Significant Meteorological Information (SIGMET) reports, Volcanic Ash Advisory (VAA) reports, and Tropical Cyclone Advisory (TCA) messages.
3.6 OPMET IWXXM Data
OPMET information is also available in a machine readable IWXXM (ICAO Meteorological Information eXchange Model) format. Data currently available in IWXXM format includes METARs, SPECIs, TAFs, SIGMETs, VAA reports, and TCA messages.
3.7 Administrative Messages
WIFS maintains a limited archive of administrative messages. See Table 3-4 for details. WIFS administrative messages may contain information on delayed data and products, updates to WIFS file structure and formats, and general information related to WAFS. (Section 6.6 has information on other means of communicating administrative messages.)
Table 3-4 Administrative Message Types
WMO Header | Description |
---|---|
FXUS65 KWBC and FXUK65 EGGR | These are used by the WAFCs to alert users to corrections to the WAFC charts |
NOXX10 KKCI | These are WIFS administrative messages |
NOXX10 KWBC | Notice of potential service outages |
NOUS42 KWNO | Administrative messages from NCEP Central Operations |
FXUS65 | Notification of SIGWX corrections |
3.8 Sources of WIFS Information Content
OPMET, forecasts and data products which are available to users on WIFS are found at:
- OPMET information (METAR, SPECI and TAF):
FASID Table MET 2A - WAFS forecasts - Same as SADIS access described in the SADIS Users Guide, Part 1, Annex 4 found at:
SADIS Users Guide, Part One
Additional Aeronautical Meteorological Information - Same as described in the SADIS Users Guide, Part 1, Annex 5 (see link above) except for the following:- AIRMETS
- GAMETS
4 WIFS User Authorization
The United States as a WAFS Provider State has agreed to support the operation of WAFC Washington along with the provision of making WAFS services available to all Contracting States as recognized in ICAO Regional Air Navigation Plans. WIFS is not an open system and requires all users to be approved for access by the:
- ICAO State Met Authority or the designated WIFS Approval Official registered with the ICAO Region and
- FAA as the ICAO designated Meteorological Authority for the U.S. and as a WAFS Provider State.
WIFS access is restricted to those individuals (or activities) who support meteorological services for the conduct or development of international air navigation. The following categories of users may be provided access based on submission and approval of a WIFS Registration Form as described in Section 4.1:
- State MET Authority and designated representatives
- State National Meteorological & Hydrologic Service Providers including Volcanic Ash and Tropical Cyclone Advisory Centers
- State Units supporting air traffic services, search and rescue services, aeronautical information services
- International Air Carrier Operators
- Meteorological Service Provider Vendors which provide meteorological services for International Air Carrier Operators
- WAFS Workstation Vendors
- Other Aeronautical Users (i.e., Any entity that is deemed by the State and the WIFS Provider State to have a need for WAFS services.)
- SADIS Backup User
WIFS Users are advised that their account may be terminated if it is determined the account is being used for purposes other than the original intent in support of international air navigation.
4.1 WIFS Registration
Approving an applicant request for access to WIFS requires submission and processing of a WIFS Registration Form as outlined in the following steps:
Applicant (Completes Steps 1 and 2):
- Determines whether WIFS or SADIS is the primary service for obtaining WAFS forecasts for operational use as required in ICAO Regional Air Navigation Plans (RANPs) for their location. (See Figure 2-1: WIFS and SADIS Area Designations).
NOTE:WIFS provides primary service for North American, Central America, and Caribbean (NACC); and South America (SAM) Regions. WIFS and SADIS share primary responsibility in the Asia and Pacific (APAC) region as listed in the APAC FASID Table 6 (https://www.icao.int/APAC/Pages/edocs-fasid.aspx). Section 4.3 provides further background on factors related to establishing SADIS and WIFS operational and backup accounts. - Completes and submits the WIFS Registration form online (https://aviationweather.gov/wifs/). Fields on the form with an (*) are required. Failure to provide accurate information may result in a processing delay or denial of a WIFS account.
Comments Section: Include a description of the intended use of the WIFS service indicating how that use relates to developing or conducting meteorological services supporting international air navigation.
FAA (Completes Steps 3 & 4 as the WIFS Approval Authority):
- Reviews the WIFS Registration request and confirms the State Approval and/or the status of an existing SADIS account if the WIFS access is for SADIS backup.
- Approves (or denies) the Registration request.
NWS/AWC (Completes Step 5 as the WIFS service provider):
- Advises the Applicant of the status. If approved, issues a Password and User Name; and adds the applicant as an approved WIFS User (primary or backup).
Figure 4-1 shows a snapshot of the current WIFS Registration Form available on the WIFS home page. Upon completion of the registration form, a confirmation screen will be displayed showing that the account was successfully submitted for approval. Review and approval processing normally takes 15-20 business days.
Figure 4-1 WIFS Registration Form
4.2 WIFS Password Policy
The current password policy is that the password does not expire but may expire with updates to password policy. Users may change their password by going to the WIFS website and clicking on "Manage Account" and clicking on "Change WIFS Password". Passwords must be at least 12 characters and must contain at least one: one upper case, one lower case, one digit [0-9] and one special character from "!@#$%^&*()". In order for the SADIS and WIFS providers to appropriately manage and maintain viable, mutually existing services delivering WAFS forecasts, the following process should be followed within a particular State in arranging to obtain their data. For Primary Operational Use (see Figure 2-1) from: The definition of the threshold for operational versus backup purposes to be used on the SADIS and WIFS Internet-based services was defined and endorsed by the ICAO SADIS Operations Group (SADISOPSG) and is described in the notes below. The policy limits backup access to a maximum of one day in seven. In the event of unavailability of the SADIS service, unlimited access to WIFS will be granted until the SADIS service has been restored. Note 1. - The specific days/times States/users wish to test their accounts is at the State/user's discretion so long as it does not exceed once every seven days. Note 2. - Backup accounts will be maintained in a “live” status in order that immediate access is available in the event of a genuine need to access the alternative Provider's service for backup purposes. Note 3. - The SADIS and WIFS Providers will monitor their services to determine user access behavior. Note 4. - It remains the sole responsibility of the State/user to determine if they require a backup account from the alternative Provider, and if so, to arrange for that account. WIFS access may be suspended by the WIFS approving authority for unauthorized use of WIFS. Access to SADIS and WIFS as back-up services may be suspended by the WIFS and SADIS approving authorities if user’s primary WIFS or SADIS accounts are suspended. WIFS does not deliver (“push”) data to the user but requires the user to collect (“pull”) data off the file servers. User access to the WIFS files servers is by a Secure Hypertext Transfer Protocol (HTTPS) session over the Internet. Files can be downloaded across this secure connection using an Internet browser or software tools such as GNU wget. The wget tool is freely available and designed to retrieve content from web-based file servers. More information about how to use WIFS and wget can be found in Appendices A and B. The minimum recommended Internet connection speed is 64 kbps for OPMET, BUFR and PNG data. The minimum connection speed for GRIB2 data is 512 kbps. Once the data are retrieved from WIFS, users will need software that is capable of processing and displaying WAFS data. A list of WAFS software providers can be found on the Vendors page at https://aviationweather.gov/wifs/. Users should contact specific providers for cost and availability. WIFS users access the WIFS file servers using thehttps://aviationweather.gov/wifs/data/URL. Figure 6-1 depicts the WIFS directory structure and the names of the individual folders, with respect to the base URL (e.g.,https://aviationweather.gov/wifs/data/). The BUFR files are generated every 6 hours and the WIFS BUFR folder contains the past 36 hours of SIGWX forecasts in BUFR format. Figure 6-2 is an example of the files that can be found in this folder. The file naming convention for these files is: YYYYMMDD_HH00_TTAAii_CCCC.bufrwhere YYYY = 4-digit year For details on the format of the BUFR products see WMO Publication FM94 BUFR. Note: Starting in February 2024, new 0.25 degree grids are available via the WIFS API with 56 vertical levels up to FL600 and 39 forecast times out to T+120. These grids are not available on the legacy WIFS data pages. See the WIFS API page for more details on how to access these new grids. The WAFS GRIB2 files are generated every 6 hours. The GRIB2 folder contains all the forecasts from the past 18 hours. The individual bulletins are concatenated together according to the forecast valid time. Figure 6-3 depicts an example of the files that can be found under the GRIB2 folder. The file naming convention for GRIB2 files is: YYYYMMDD_hhmmfFF.grib2where YYYY = 4-digit year The gridded files are formatted in accordance with WMO code FM 92 (GRIB Version 2), and are described in full detail in "WMO Manual on Codes, Volume I, Part B (WMO No. 306). Software libraries to decode data in GRIB2 data are provided by the National Centers for Environmental Prediction (NCEP), and can be found at: https://www.nco.ncep.noaa.gov/pmb/codes/GRIB2/ These files are available both as a full global dataset and in regional subsets or tiles of data. The tiles are so that the users do not have to download the entire global dataset if they do not need it, which saves bandwidth. The figure below shows the areas covered by each regional tile. The below snapshot shows how the directory looks for the 0.25 degree hazard files. Note the eight smaller regional files. The WIFS server provides OPMET data (METARs/SPECIs, TAFs, SIGMETs, Advisories, PIREPs) in character-oriented format, often referred to as Traditional Alphanumeric Coding (TAC). These data are made available based on the following criteria: Each file within this folder contains all OPMET data that was received by NWS during a given hour. 36 hours of data are continuously maintained, and every hour a new file is generated from the most recent hour’s data, and the oldest file is removed from the WIFS server. Figure 6-4 depicts a snapshot of the files maintained in this folder. The file naming convention for OPMET-HOURLY files is: YYYYMMDD_hh_OPMETwhere YYYY = 4-digit year Each file within this folder contains all OPMET data received during a given minute. Thirty-six (36) hours of data are continuously maintained. Every minute a new file is generated from the most recent hour’s data and the oldest file is removed. Figure 6-5 depicts a snapshot of the files maintained in this folder. The file naming convention for OPMET-MINUTE files is: YYYYMMDD_hhmm_OPMETwhere YYYY=4-digit year There are five individual OPMET data files within this folder that are generated from the OPMET_MINUTE files. The OPMET files contain multiple WMO records are formatted in accordance with WMO Publication 386. The WIFS server provides OPMET IWXXM data (METARs/SPECIs, TAFs, SIGMETs, Advisories) in XML format. These data are made available based on the following criteria: Each minute file file is a collection of products much like the alphanumeric data are. But to preserve the XML nature of the data, each product is put into a file by itself and then added to a tar file. Each minute tar file is a collection of products for that minute only. Then the tar file is gzip compressed. For example, the 20240205_0153_IWXXM_MINUTE.tgz contains: The files use the WMO header to define their content as: after uncompressing and untaring the file, the individual products may be viewed and decoded. If no new data comes in for a minute, no file will be generated. The IWXXM 5 minute files are a collection of minute files which are then added to a tar file and gzip compressed like the minute files are. For example, the 20240205_0245_IWXXM_5MIN.tgz has in it the following minute files: So to get to the data, the tar file must be untar'd into its minute files. Then each minute file must be untar'd to get to the data. It's a 2 step process. The IWXXM hourly files are a collection of 5 minute files which are then added to a tar file and gzip compressed like the minute files are. For example, the 20240205_02_IWXXM_HOURLY.tgz has in it the following 5 minute files: So to get to the data, it's the same as the 5 minute files except there is one extra step of untaring the hourly file into its 5 minute files. The files are in the IWXXM root directory (see Figure 6-7). The files have the following contents: The IWXXM format is a standard for interchanging meteorological data using machine readable XML/GML. A XML definition, schema and examples are included in ICAO Annex 3. For more information, see the WMO IWXXM schema directory. Portable Network Graphic (PNG) images of the Significant Weather ICAO area charts are stored in the PNG folder of the WIFS file system. The WMO messages in Table 6-1 are retained in the PNG folder for 36 hours. Additional information pertaining to the areas referenced in Table 6-1 can be found in Figure 6-9. Table 6-1 Significant Weather PNG Files Volcanic ash and tropical cyclone graphics in PNG format are also available when advisories are issued. These products will have a WMO header starting with PFXD (volcanic ash) and PZXD (tropical cyclone). Figure 6-10 and Figure 6-11 depict snapshots of the files maintained in the SIGWX and VOLC folders, respectively. The file naming convention for these files is: YYYYMMDD_HH00_TTAAii_CCCC.pngwhere YYYY=4-digit year For detailed information on the PNG format, see the W3C Portable Network Graphics (PNG) Specification (Second Edition) (https://www.w3.org/TR/PNG). Administrative messages are retained on WIFS for 36 hours. Each file contains a single message. Figure 6-12 is a snapshot of the administrative messages found on the WIFS servers. The file naming convention for these files is: YYYYMMDD_hhmm_TTAAii_CCCC.adm where YYYY = 4-digit year The Administrative message files contain a single WMO record formatted in accordance with WMO Publication 386. Any routine changes to the WIFS Directory structure, content, or the formats of the WIFS files will be communicated at least 30 days in advance of the scheduled implementation via an “NOXX10 KKCI” Administrative message and to the user’s registered email on file. In addition, requirement changes that are agreed upon and announced at the ICAO Met Panel (Working Group-Meteorological Operations Group) and other regional meetings may result in modifications to the file content and data structure. Examples of new WIFS content and formats will be made available for WIFS User testing to identify any impacts to user WIFS processing or display systems. WIFS Customer Support will be available to assist WIFS Users in resolving any issues with user logins, data timeliness, and network outages. The WIFS support website can be accessed by opening the following link in a web browser:https://aviationweather.gov/wifs/. The intent of this web site is to provide users with an online portal for information pertaining to WIFS. The web site has the following key capabilities: The WIFS Help Desk is available to address issues Monday through Friday between the hours of 7am to 3pm US Central Time. To contact the WIFS Help Desk: Table 9-1 provides an initial set of troubleshooting guidelines to help users with possible issues. This information can also be found on the WIFS Support web-site which may be updated with more troubleshooting guidelines. Note: Users can check the status of all WIFS files by visiting https://aviationweather.gov/wifs/#status. Table 9-1 Troubleshooting Guidelines Notes: Once you are authorized to use WIFS (see Section 4) you can begin downloading data at any time. The basic technical requirement for using WIFS is a computer system equipped with the following components: Use Case Example 1 – Downloading a single file using the web browser Below is a use-case scenario for how a fictitious user (John Smith) identifies a single file he wants and uses his web browser to download it from WIFS. In this case, John knows he wants a Significant Weather PNG chart. Use Case Example 2 – Downloading a single file using the GNU wget tool Below is a use-case scenario for how a fictitious user (John Smith) identifies a single file he wants and uses wget to download it from WIFS. In this case, John knows he wants a Significant Weather PNG chart. Use Case Example 3 – Downloading multiple files at once Below is a use-case scenario for how a fictitious user (John Smith) uses Wget to download multiple files at once from WIFS. In this case, John knows he wants all of the PNG charts. All of the files in the PNG directory will be downloaded to the current working directory on John’s computer. GNU wget is a free software package for retrieving files using HTTP, HTTPS and FTP, the most widely-used Internet protocols. It is a non-interactive command-line tool that can be executed from programs, scripts, and cron jobs. GNU wget has many features to make retrieving large files easy, including: To download GNU wget, navigate to https://ftp.gnu.org/gnu/wget/. GNU wget documentation can be found at https://www.gnu.org/software/wget/manual/. The structure of the command including only the required arguments is described below. The wget utility is powerful and includes the capability of performing recursion, statistics, logging, and much more. wget --user=<user> --password=<password> <URL> where user = your WIFS login name Note: Starting in February 2024, new 0.25 degree grids are available via the WIFS API with 56 vertical levels up to FL600 and 39 forecast times out to T+120. These grids are not available on the legacy WIFS data pages. See the WIFS API page for more details on how to access these new grids. The following data sets are provided for T+6, T+9, T+12, T+15, T+18, T+21, T+24, T+27, T+30, T+33 and T+36. Notable Grid Characteristics: Issuance times: Grid details: File sizes:4.3 Determining Operational and Backup Service Use
NOTE: Cost recovery is not required for a backup account provided the SADIS procedures are followed. Additional background is available in the SADIS User Guide/Part One
For requests coming from the ICAO APAC Region, the State determines which of the two services (SADIS or WIFS) to obtain their primary operational access to WAFS forecasts; follow the appropriate procedures in subsections A or B above.
In exceptional circumstances, States that have an operational requirement to obtain data from both WIFS and SADIS on a continuous basis will have their requests considered on a case-by-case basis. Under such circumstances a State taking both services will be required to contribute fully to the SADIS cost recovery scheme (unless recognized as a United Nations Least Developed Country).4.4 WIFS Backup to SADIS
4.5 Suspension of Access
5 Data Retrieval Process
6 WIFS Directory Structure and File Formats
Figure 6-1 WIFS Directory Structure.
Note: updated directories for new data, and removal of discontinued data.6.1 BUFR Files
Figure 6-2 Snapshot of the BUFR folder
MM = 2-digit month
DD = 2-digit day
HH = 2-digit hour of forecast package valid time
00 = Fixed characters
TTAAii_CCCC = WMO header and site identifier
.bufr = File extension6.1.1 Format of BUFR Files
6.2 GRIB2 Gridded Files
Figure 6-3 Snapshot of the GRIB2 folder
MM = 2-digit month
DD = 2-digit day
hh = 2-digit hour of model run
mm = 2-digit minute of model run
f = Fixed character
FF = 2-digit forecast hour
.grib2 = File extension6.2.1 Format of Gridded Files
6.2.2 Format of 0.25 Degree Gridded Hazard Files
Figure 6-3.1 Pre-Set Map Areas
Figure 6-3.2 0.25 Degree Hazard File Snapshot6.3 OPMET Alphanumeric Data Files
6.3.1 OPMET-HOURLY
Figure 6-4 Snapshot of the OPMET-Hourly Folder
MM = 2-digit month
DD =2-digit day
hh = 2-digit start hour of collected data
OPMET = Fixed text6.3.2 OPMET-MINUTE
Figure 6-5 Snapshot of the OPMET-MINUTE folder
MM = 2-digit month
DD = 2-digit day
hh = 2-digit start hour of collected data
mm = 2-digit start minute within the hh hour of collected data
OPMET = Fixed text6.3.3 OPMET-ROLLING
Figure 6-6 Snapshot of the OPMET-ROLLING folder6.3.4 Format of OPMET Files
6.4 OPMET IWXXM Files
Figure 6-7 Snapshot of the IWXXM folder6.4.1 IWXXM MINUTE
-rw-r--r-- ldm/ops 4297 2024-02-04 19:53 LAUS23_KWBC_050200.xml
-rw-r--r-- ldm/ops 6845 2024-02-04 19:53 LAUS25_KWBC_050200.xml
-rw-r--r-- ldm/ops 9990 2024-02-04 19:53 LAUS21_KWBC_050200.xml
-rw-r--r-- ldm/ops 4096 2024-02-04 19:53 LAUS24_KWBC_050200.xml
-rw-r--r-- ldm/ops 11450 2024-02-04 19:53 LPUS23_KWBC_050152.xml
-rw-r--r-- ldm/ops 10513 2024-02-04 19:53 LPUS22_KWBC_050152.xml
-rw-r--r-- ldm/ops 4290 2024-02-04 19:53 LPUS24_KWBC_050152.xml
Figure 6-8 Snapshot of the IWXXM MINUTE folder6.4.2 IWXXM 5MINUTE
-rw-r--r-- ldm/ops 8495 2024-02-04 20:41 20240205_0241_IWXXM_MINUTE.tgz
-rw-r--r-- ldm/ops 1957 2024-02-04 20:42 20240205_0242_IWXXM_MINUTE.tgz
-rw-r--r-- ldm/ops 8371 2024-02-04 20:43 20240205_0243_IWXXM_MINUTE.tgz
-rw-r--r-- ldm/ops 8227 2024-02-04 20:44 20240205_0244_IWXXM_MINUTE.tgz
-rw-r--r-- ldm/ops 4610 2024-02-04 20:45 20240205_0245_IWXXM_MINUTE.tgz
6.4.3 IWXXM HOURLY
-rw-r--r-- ldm/ops 31766 2024-02-04 19:05 20240205_0105_IWXXM_5MIN.tgz
-rw-r--r-- ldm/ops 12327 2024-02-04 19:12 20240205_0110_IWXXM_5MIN.tgz
-rw-r--r-- ldm/ops 18917 2024-02-04 19:17 20240205_0115_IWXXM_5MIN.tgz
-rw-r--r-- ldm/ops 15570 2024-02-04 19:20 20240205_0120_IWXXM_5MIN.tgz
-rw-r--r-- ldm/ops 21336 2024-02-04 19:25 20240205_0125_IWXXM_5MIN.tgz
-rw-r--r-- ldm/ops 8305 2024-02-04 19:32 20240205_0130_IWXXM_5MIN.tgz
-rw-r--r-- ldm/ops 15707 2024-02-04 19:35 20240205_0135_IWXXM_5MIN.tgz
-rw-r--r-- ldm/ops 11107 2024-02-04 19:42 20240205_0140_IWXXM_5MIN.tgz
-rw-r--r-- ldm/ops 15843 2024-02-04 19:45 20240205_0145_IWXXM_5MIN.tgz
-rw-r--r-- ldm/ops 12085 2024-02-04 19:52 20240205_0150_IWXXM_5MIN.tgz
-rw-r--r-- ldm/ops 35997 2024-02-04 19:55 20240205_0155_IWXXM_5MIN.tgz
-rw-r--r-- ldm/ops 190237 2024-02-04 20:00 20240205_0200_IWXXM_5MIN.tgz
6.4.4 IWXXM Rolling Files
6.4.5 Format of IWXXM Files
6.5 PNG Files
WMO Header Area PGEE05 KKCI ICAO A PGIE05 KKCI ICAO B1 PGGE05 KKCI ICAO F PGAE05 KKCI ICAO H PGBE05 KKCI ICAO I PGJE05 KKCI ICAO J PGDE29 KKCI ICAO M PGNE14 KKCI North Atlantic Ocean Region
Figure 6-9 ICAO Regions
Figure 6-10 Snapshot of the PNG SIGWX KWBC folder
Figure 6-11 Snapshot of the PNG VOLC folder
MM = 2-digit month
DD = 2-digit day
HH = 2-digit hour of forecast package valid time
00 = Fixed characters
TTAAii_CCCC = WMO header and site identifier
.png = File extension6.5.1 Format of PNG Files
6.6 ADMIN_MSGS
Figure 6-12 Snapshot of the ADMIN_MSGS folder
MM = 2-digit month
DD = 2-digit day
hh = 2-digit hour of message issuance time
mm = 2-digit minute of message issuance time
TTAAii_CCCC = WMO header and site identifier
.adm = File extension6.6.1 Format of Administrative Message Files
6.7 Announcing Changes in Services or Products
7 WIFS Support Web Site
8 WIFS Help Desk
E-mail: wifs.admin@noaa.gov
Phone: +1 (877) 280-2811
For operational issues outside of normal WIFS Help Desk hours, expect a response within 3 hours after the Help Desk re-opens.9 User Troubleshooting Guidelines
Symptom Probable Cause Actions to Take Data are out of date, cannot be retrieved, is not being properly displayed, or missing on the workstation WAFS data retrieve process failed Test the internet connection1 Check the data retrieve log file for errors2 Contact the WAFS workstation support team Data on WIFS is out of date Test the internet connection1 Check the WIFS status page https://aviationweather.gov/wifs/#status. Browse to the WIFS online file list and check to see if data are up to date3 Contact the WIFS Help Desk. See Section 8 for procedure. There is a WIFS data ingest problem Check the Advisories page for new advisories pertaining to data outages. Contact the WIFS Help Desk. See Section 8 for procedure. Appendix A. Using WIFS
wget --user=johnsmith --password=wxdude https://aviationweather.gov/wifs/data/PNG/SIGWX/KWBC/
On the command line from his computer, John types the following command:
wget --user=johnsmith --password=wxdude https://aviationweather.gov/wifs/data/PNG/SIGWX/KWBC/20100715_0600_PGEE05_KKCI.png
wget --user=johnsmith --password=wxdude --recursive --no-directories https://aviationweather.gov/wifs/data/PNG/SIGWX/KWBC/Appendix B. GNU wget
password = your WIFS password
Note: password may need single quotes around it to prevent shell from mis-interpreting the passwordAppendix C. WAFS Upper Air GRIB2 Details (Web only)
Note: removal of 1.25 deg hazard grids.1.25° Resolution 0.25° Resolution Flight Levels U-component Wind FL050, FL080, FL100, FL140, FL180, FL210, FL240, FL270, FL300, FL275, FL300, FL340, FL360, FL390, FL410, FL450, FL480, FL530 V-component Wind FL050, FL080, FL100, FL140, FL180, FL210, FL240, FL270, FL300, FL275, FL300, FL340, FL360, FL390, FL410, FL450, FL480, FL530 Temperature FL050, FL080, FL100, FL140, FL180, FL210, FL240, FL270, FL300, FL275, FL300, FL340, FL360, FL390, FL410, FL450, FL480, FL530 Relative Humidity FL050, FLOSO, FL100, FL140, FL180 Tropopause Height (tropopause) Tropopause Temperature (tropopause) Maximum U-component (height of jet stream) Maximum V-component (height of jet stream) Geopotential Height of Standard Levels FL050, FL080, FL100, FL140, FL180, FL210, FL240, FL270, FL300, FL275, FL300, FL340, FL360, FL390, FL410, FL450, FL480, FL530 Icing Severity FL060, FL 100, FL140, FL180, FL240, FL300 Turbulence FL100, FL140, FL180, FL240, FL270, FL300, FL340, FL390, FL450 Cb Hortizontal Extent n/a ICAO Height at Cb Base n/a ICAO Height at Cb Top n/a