FIADB EVALIDator API Documentation and Examples

1. 2018 NRS FIA Management Team MeetingBatch EVALIDator – EVALIDator APIDecember 11-12, 2018 — Manhattan, KansasAPI by Pat MilesPresented by Scott Pugh • FIADB Application Programming Interface (API) • uses GET and POST commands to return info via HTML, XML or JSON • https://apps.fs.usda.gov/fia/datamart/images/datamart_api_tutorials.html • Batch EVALIDator reports using MS-Excel and API • https://apps.fs.usda.gov/fia/datamart/datamart_excel.html • Next steps

2. FIADB//EVALIDator Application Programming Interface (API)Documentation and Examples • API Documentation • FIADB Application Programming Interfaces • JAVA EVALIDatorfullreportPost API POST request source code example • JAVA EVALIDatorfullreport API GET request source code example • List of EVALIDator population estimates • List of EVALIDator page, row, and column labels • https://apps.fs.usda.gov/fia/datamart/images/datamart_api_tutorials.html • FIADB Documentation • Description and User Guide • Population Estimation User Guide • https://www.fia.fs.fed.us/library/database-documentation/

3. Running the EVALIDator using the fullreport API GET request (https://apps.fs.usda.gov/fia/datamart/images/datamart_api_tutorials.html) The fullreport request can return output in either HTML, JSON, or XML format. The following example returns forest land area estimates for a circular area centered at 45.0 degrees latitude and -93.0 degrees longitude with a radius of 50 miles. Information from the 2015 inventory of Minnesota (evaludation group 272015) and Wisconsin (evaluation group 552015) is used. Click on the hyperlink or copy the hyperlink and paste it in your browser's address line to submit the fullreport request. After several seconds a report of population estimates with associated sampling errors and the number or non-zero plots used to obtain the estimates will be returned.http://apps.fs.fed.us/Evalidator/rest/Evalidator/fullreport?reptype=Circle&lat=45.0&lon=-93.0&radius=50&snum=Area of forest land, in acres&sdenom=No denominator - just produce estimates&wc=272015,552015&pselected=None&rselected=State code&cselected=Stand-size class&ptime=Current&rtime=Current&ctime=Current&wf=&wnum= &wnumdenom= &FIAorRPA=FIADEF&outputFormat=HTML&estOnly=N&schemaName=FS_FIADB.&r1=&c1= This next example returns estimates of the area of forest land for Minnesota and Wisconsin by State and stand-size for the 2015 inventories.http://apps.fs.fed.us/Evalidator/rest/Evalidator/fullreport?reptype=State&lat=0&lon=0&radius=0&snum=Area of forest land, in acres&sdenom=No denominator - just produce estimates&wc=272015,552015&pselected=None&rselected=State code&cselected=Stand-size class&ptime=Current&rtime=Current&ctime=Current&wf=&wnum= &wnumdenom= &FIAorRPA=FIADEF&outputFormat=HTML&estOnly=N&schemaName=FS_FIADB.&r1=&c1=

4. Batch EVALIDator reports using MS-Excel and fullreport GET API (https://apps.fs.usda.gov/fia/datamart/images/datamart_api_tutorials.html) The EVALIDatorfullreport API makes it possible to run multiple reports in batch mode. Multiple reports could be run for a single location, or a single report could be run for multiple locations. For example, in the first case it would be possible to generate a set of reports for a single national forest while in the second case volume estimates could be generated for many locations to help in the siting of a new sawmill. A standard set of reports have been created for each State and are available for downloading from Microsoft Excel 2013 workbooks containing many reports for the most recent State inventories. The reports have already been generated in these workbooks. If you would like to rerun the reports yourself you will have to set the "Trusted location" and "Enable macros" within the workbook in order for the "Query" button on the "Inputs" worksheet to work.

5. https://apps.fs.usda.gov/fia/datamart/datamart_excel.html

6. Next Steps • GeoJSON output option to fullreport and fullreportPost API’s • Chloropleth maps of counties, HUC’s, Congressional Districts, Ecosections, … • E.g., forest area by congressional code for Minnesota and Wisconsin • http://fsxopsx1432.wrk.fs.usda.gov:32768/Evalidator/rest/Evalidator/geojson?colList=plotgeom.statecd,plotgeom.congcd&attribute_nbr=3&whereStr=and%20PEG.EVAL_GRP%20IN%20(552015,272015)&table=CONGCD8265&threshold=0&tolerance=0.5&remove_loops=0 • Estimator API • Allows output by as many reporting variables as possible in FIADB • I.e., output is not constrained to pages, rows and columns • E.g., –Number of trees by diameter class, county, species and forest type • http://fsxopsx1432.wrk.fs.usda.gov:32768/Evalidator/rest/Evalidator/estimator?colList=trunc(tree.dia),fs_fiadb.evalidatorfunctions.countycdlabel(plot.statecd,plot.countycd),fs_fiadb.evalidatorfunctions.spcdlabel(tree.spcd),fs_fiadb.cond.fortypcd &attribute_nbr=4&whereStr=and%20PEG.EVAL_GRP%20IN%20(092015,102015)&outputFormat=csv • NUTS API for National Urban Tree Statistics (API for Urban EVALIDator) • Difference Tester API • Test for significant difference in estimates between two consecutive inventories

7. Difference Tester: Totals • https://apps.fs.usda.gov/Evalidator/diftester.jsp • Difference Tester: Ratios • https://apps.fs.usda.gov/Evalidator/diftesterratio.jsp • Reference • Westfall, James A.; Pugh, Scott A.; Coulston, John W. 2013.  • Conducting tests for statistically significant differences using forest inventory data. • Res. Pap. NRS-22. Newtown Square, PA: U.S. Department of Agriculture, Forest Service, • Northern Research Station. 10 p. • User Guide – In development