FSH 5109.19 - FIRE MANAGEMENT ANALYSIS AND PLANNING HANDBOOK 1/83 WO AMENDMENT 1 83.85 - Diagnostics (Input error 1-4 and 9 are not used in this program.) **** INPUT ERROR 5 -- TITLE CARD HAS ALREADY BEEN SPECIFIED. RUN TERMINATED. Action: Remove duplicate title card. **** INPUT ERROR 6 -- PERIOD CARD HAS ALREADY BEEN SPECIFIED. RUN TERMINATED. Action: Remove the duplicate or incorrect period card. **** INPUT ERROR 7 -- THE YEAR 19?? EXCEEDS ALLOWABLE RANGE (1970-19??). Action: Correct the input year to be between 70 and one less than the current year. **** INPUT ERROR 8 -- EARLY AND LATE PERIODS CANNOT OVERLAP. ALSO THE UPPER YEAR CANNOT BE LESS THAN THE LOWER YEAR FOR A GIVEN PERIOD. Action: Year data input must be in ascending sequence. **** INPUT ERROR 10 -- MAXIMUM NUMBER OF CAUSE CARDS EXCEEDED. RUN TERMINATED. Action: Remove all cause cards exceeding 8. **** INPUT ERROR 11 -- CAPABILITY AREA CARD(S) MUST FOLLOW ANALYSIS AREA CARDS. RUN TERMINATED. Action: Capability area cards are out of order. Replace them in the correct sequence. **** INPUT ERROR 12 -- ABOVE CARD TYPE IS INVALID. RUN TERMINATED. Action: Either analysis cards expected and not found or invalid card type input. Correct data. **** INPUT ERROR 13 -- TITLE CARD NOT SPECIFIED. RUN TERMINATED. Action: Add title card to run setup. **** INPUT ERROR 14 -- USERS INPUT DATA IS NOT COMPLETE (LACKS CARDS). Action: Enter missing lead cards. **** INPUT ERROR 15 -- CAPABILITY AREA ?? FOR ANALYSIS AREA ?? CONNOT BE FOUND IN THE HISTORICAL FIRE OCCURRENCE DATA. Action: Check geographic area ID on CAP AREA card for specified analysis area FPL-FREQ lead card against the capability area ID on FIRE card FPL-AREA lead card, for correct alpha-numeric code and justification. **** INPUT ERROR 16 -- THE AGGREGATION TYPE CARD HAS ALREADY BEEN SPECIFIED. RUN TERMINATED. Action: Remove the duplicate or incorrect aggregation card. **** INPUT ERROR 17 -- INVALID OPTION SPECIFIED ON THE OUPUT TYPE CARD. RUN TERMINATED. Action: The option must be a "T" or "L" on the output card. **** ERROR SUMMARY -- ?? INPUT ERRORS WERE DETECTED. **** PROGRAM EXECUTION TERMINATED **** Action: 1 or more fatal errors were detected. Correct data. **** AN INTENSITY LEVEL OF ZERO WAS ENCOUNTERED IN THIS RUN. THIS IMPLIES THAT THE FILE NEEDED TO PROCESS WITH PROGRAM FPL-FREQ HAS NOT BEEN PREPROCESSED THROUGH PROGRAM FPL-LEVEL1. PROCESS THE FPLRRFF*REPORTS-AREA FILE THROUGH PROGRAM FPL-LEVEL1. RUN TERMINATED. Action: Process the FPLRRFF*REPORTS-AREA through program FPL-LEVEL1. **** A FIRE OCCURRENCE YEAR WAS ENCOUNTERED IN FIRE REPORT ???????? WHICH EXCEEDS ARRAY LIMITS. RUN TERMINATED. Action: The range of years selected exceeds 30. Adjust years of fire occurrence data from input records to be less than 31 years total. If an error is detected, a summary message is printed at the end of the input data error scan and the run is terminated. 83.86 - Run/Lead Card Deck @RUN,P RUN-ID,ACCT-NO,FPLRRFF,5,250 @ASG,A FPLRRFF*REPORTS-SORT. @ASG,A FPL-FIREPLAN*FPL-PROGRAMS. @USE 9.,FPLRRFF*REPORTS-SORT. @XQT FPL-FIREPLAN*FPL-PROGRAMS.FPL-FREQ TITLE CARD AGGR CARD OUTPUT CARD (OPTIONAL) PERIOD CARD (OPTIONAL) CAUSE CARD 1 (OPTIONAL) o o ETC. o CAUSE CARD 8 ANALYSIS CARD 1 CAP AREA CARD 1 o o ETC. o CAP AREA CARD N o o ETC. o ANALYSIS CARD N CAP AREA CARD 1 o o ETC. o CAP AREA CARD N @FIN FILE CREATED: NONE 83.9 - FPL-FIREPLAN*FPL-PROGRAMS.FPL-LEVEL2 83.91 - Lead Cards. Only one lead card is needed to run /FPL-LEVEL2/. But as many of these cards as there are FMAZ's in a management area are included in a single run. The cards must be ordered by weather station number, the lowest being first in the deck. 83.92 - Lead Card Specification, Program /FPL-LEVEL2/ TYPE BEGIN END NO. DATA TYPE AND CARD COL. COL. COLS. DESCRIPTION FOOTNOTES FMAZ Descriptor 1 1 1 Enter '2' Numeric (I1) 2 13 12 Forest Name Alpha (3A4) 14 18 5 FMAZ Identifier Alpha-Numeric (A5) 19 24 6 Weather Station Numeric (I6) Number 25 26 2 Begin Year Numeric (I2) 27 28 2 End Year Numeric (I2) 29 29 1 Enter 'F' or 'T' Alpha (A1) 3/ 30 30 1 Leave Blank 31 32 2 Site/Fuel Option Alpha-Numeric Identifier (A2) FMAZ Descriptor 33 33 1 Position of Fires Alpha (A1) 1/ on Slope (U is upper 1/3rd, M is Middle 1/3rd, L is lowest 1/3rd). 34 34 1 NFDRS Slope Class Numeric (I1) (Coded 1,2, or 3) 1/, 4/ 35 35 1 Aspect (E is East, Alpha (A1) 1/ W is West, N is North, S is South 36 36 1 Herbaceous Vegetation Alpha (A1) 1/ Type (A=Annuals P=Perennials) 37 37 1 First NFDRS Fuel Alpha (A1)1/, Model 2/ 38 39 2 Percent of Area Numeric (I2) Covered by First 1/, 2/ NFDRS Fuel Model; if 100 Percent, Code as 99 40 40 1 Second NFDRS Fuel Alpha (A1) Model 1/, 2/ 41 42 2 Percent of Area Numeric (I2) Covered by Second 1/, 2/ Fuel Model 1/ Items in cols. 31 through 42 can be repeated up to 3 times in cols. 43-54, 55-66, and 67-78 if additional trial combinations of site/fuel factors are wanted. 2/ If only one fuel model is used enter its alphabetic designator in col. 37, A 99 in cols. 38 and 39, and leave cols. 40-42 blank. 3/ 'T' causes tables for flame length and rate of spread, area at 1 hour, perimeter at 1 hour as functions of intensity class to be printed; 'F' limits the table output to flame length and the rate-of-spread tables. 4/ Code NFDRS Slope Classes 4 and 5 as 3. 83.93 - Sample Lead Card Deck, Program /FPL-LEVEL2/ 12345678901234567890123456789012345678901234567890 2STANISLAUS T-02 0436037078F 1L1WPB80A20 2L1SPB80A 2STANISLAUS 04 0436057078F 1L2SPK50G50 83.94 - Output. Outputs of program /FPL-LEVEL2/, besides images of lead cards, (ex. 1) for each site/fuel option are: 1. Table of cumulative frequency of predicted flame lengths (ex. 2). 2. Table of frequency and cumulative frequency of rate of spread conditional on flame length (intensity level) (ex. 3). 3. Table of frequency and cumulative frequency of fire perimeter at 1 hour conditional on flame length (intensity level). Obtained by entering a 'T' in col. 29. 4. Table of frequency and cumulative frequency of fire area at one hour conditional on flame length (intensity level). Obtained by entering a 'T' in col. 29. SEE PAPER COPY FOR EXHIBITS 1-3 83.95 - Diagnostics (Input errors 8 and 9 not used in this program.) FOREST NAME --- WX STATION NBR --- SITE POSITION MUST BE L, M,U, NOT = - INPUT ERROR 1. Action: Correct noted forest FMAZ lead card column 33 for position of fires on slope code. FOREST NAME --- WX STATION NBR --- ASPECT MUST BE N,E,S,W NOT = - INPUT ERROR 2. Action: Correct noted forest FMAZ lead card column 35 for aspect code. FOREST NAME --- WX STATION NBR --- BEGIN YEAR GT END YEAR -- -- INPUT ERROR 3. Action: Correct noted forest FMAZ .ead card columns 25-28 for correct years of data order. FUEL-MOIST FILE HEADER REC. WX STATION NBR --- CLIMATE CLASS MUST BE 1-4 NOT = - INPUT ERROR 4. Action: Error in header record on the FUEL-MOIST file. Rerun FPL-MOIST. FUEL-MOIST FILE HEADER REC. WX STATION NBR --- SLOPE CLASS MUST BE 1-3 NOT = - INPUT ERROR 5. Action: Error in header record on the FUEL-MOIST file. Rerun FPL-MOIST. STATION NUMBER --- NOT ON FILE 9 INPUT ERROR 6. Action: File 9 is FUEL-MOIST file. The WX station number coded on FMAZ lead card columns 19-24 is not in the FUEL-MOIST file. Correct WX station number or rerun GETDATA2 program. ONE OR BOTH FILES ON DEVICES 8 AND 9 ARE EMPTY OR FOR WRONG STATION. INPUT ERROR 7. Action: Unit 8 is REPORTS-SORT file. Unit 9 is FUEL- MOIST file. Check for correct data files and list if necessary. Rerun FPL-LEVEL2. SLOPE CLASS MUST BE 1-3 NOT = - INPUT ERROR 10. Action: Correct slope class column 34 in FMAZ descriptor lead card listed on FPL-LEVEL2 summary page. FUEL MODEL MUST BE A-L, N-U NOT = - INPUT ERROR 11. Action: Correct NFDRS fuel model(s) column 37 or 40; 49 or 52; 61 or 64; 73 or 76 in FMAZ descriptor lead card listed on FPL-LEVEL2 summary page. HERB TYPE MUST BE A OR P NOT = - INPUT ERROR 12. Action: Correct herbaceous vegetation type column 36 in FMAZ descriptor lead card listed on FPL-LEVEL2 summary page. --- Errors encountered FPL-LEVEL2. CHECK ALL LEAD CARDS FOR CORRECT ENTRIES. RUN TERMINATED. Action: Correct all errors on noted FMAZ lead card. Check all lead cards for similar errors. Rerun FPL-LEVEL2. ER ABORT$ ABORT ADR: ------ BDI: ------ RUNSTREAM ANALYSIS TERMINATED. Action: System error to terminate runstream processing. Rerun program FPL-LEVEL2. 1. A problem arises when a FMAZ's fuel moisture set is made up of data provided by more than one weather station. (A single weather station did not operate throughout the analysis period). In such cases, the fuel moistures must be made to appear to be from one station's data set. FPLRRFF*MOIST-NNNNN is an input mass storage file required to run /FPL-LEVEL2/ when the problem noted above occurs. It provides the fuel moistures calculated from the weather data for the FMAZ. FPLRRFF*MOIST-NNNNN is extracted from FPLRRFF*FUEL-MOIST (which contains the same information for the Forest) using the text editor. The structure of FPLRRFF*MOIST-NNNNN is fuel moistures chronologically ordered by weather station. The weather station 'sets' are in ascending order of the weather station numbers. The file FPLRRFF*MOIST-NNNNN must contain weather data sets for all FMAZ's which are represented in the FPL-LEVEL2 run. NNNNN is a user supplied name to identify the FMAZ fuel moisture data set. The final step is to arrange the blocks in ascending order of station number. To do this, arrange the several component fuel moisture sets for FMAZ chronologically without regard for station number. Next, move the header record of the station with the longest record to the first line of the block. The other header records are now deleted and all station numbers (cols. 1-6) changed to that of the dominant station. 2. Correcting (entering) the intensity level at this point in processing is valid only for running programs through level I analysis for /FPL-FREQ/. If level II analysis is required, this same error of unmatched fires will be encountered when executing /FPL-LEVEL2/, as this program also matches the fire report data to the weather data. FPL-LEVEL2 defaults are: Assign a fire intensity level of 1 and a rate-of-spread of 0.01 to class A fires with no matching weather records: Drop class B+ fire records with no matching weather records. If these defaults are unacceptable, prepare weather records for the days on which these fires occurred and add them to the GETDATA2-WX file. Program FPL-MOIST and FPL-LEVEL1 will have to be rerun. See utility routine for adding weather records. 83.96 - Run/Lead Card Deck @RUN,P RUN-ID, ACCT-NO, FPLRRFF, 5,75 @ASG,A FPL-FIREPLAN*FPL-PROCRAMS. @ASG,A FPLRRFF*FUEL-MOIST. (OR FILE CREATED FROM NOTE @ASG,A FPLRRFF*REPORTS-SORT. 1 (sec. 83.95) @USE 9., FPLRRFF*FUEL-MOIST. (OR FILE CREATED FROM NOTE @USE 11., FPLRRFF*REPORTS-SORT. 1 (sec. 83.95) @XQT FPL-FIREPLAN*FPL-PROCRAMS.FPL-LEVEL2 FMAZ DESCRIPTION CARD 1 o o ETC. o FMAZ DESCRIPTION CARD N FIN File Created: None