fiadb.fullreport

Query the USFS FIADB-API / EVALIDator /fullreport endpoint for a design-based FIA population estimate and its sampling error. Returns the grouped estimate cells as a tidy CSV (ESTIMATE, VARIANCE, SE, SE_PERCENT, PLOT_COUNT plus a column per active grouping dimension). This is the power-user escape hatch behind the friendly blocks (fiadb.area, fiadb.volume, fiadb.biomass, fiadb.carbon) — use it for attributes, ratios, or groupings they don't cover. Use fiadb.parameters to discover valid snum, wc, and grouping values. Response warnings and provenance are written to the block logs.

  • Kind: standard
  • Network: yes

Inputs🔗

NameTypeDescription
wcstringEvaluation group code(s): state FIPS + 4-digit inventory year, e.g. "102020" for Delaware 2020. Multiple codes may be comma-separated.
snumstringNumerator estimate attribute number (e.g. "2" for area of forest land in acres). Use fiadb.parameters with name: snum to list valid attribute numbers and descriptions.
sdenomstringOptional ratio denominator attribute number. When set, the estimate is the ratio snum/sdenom.
rselectedstringOptional row grouping. Pass the LABEL_VAR string from the rselected parameter dictionary (e.g. "County code and name"), not the bare DB_VAR. Becomes the first grouping column.
cselectedstringOptional column grouping (LABEL_VAR string from the cselected dictionary). Becomes the second grouping column.
pselectedstringOptional page grouping (LABEL_VAR string from the pselected dictionary). Becomes the third grouping column.
rtimestringOptional temporal basis for the row grouping in change/growth/removal/mortality estimates.
ctimestringOptional temporal basis for the column grouping.
ptimestringOptional temporal basis for the page grouping.
strFilterstringOptional SQL-style filter applied to the estimate (advanced). Long filters are automatically submitted via POST.
FIAorRPAstringForest land definition: FIADEF (default) or RPADEF.
estOnlystringSet to "Y" to return grouped estimates only, skipping server-side subtotal/total computation.

Outputs🔗

NameTypeDescription
estimatesfile (CSV)Tidy CSV of estimate cells: one column per active grouping dimension followed by ESTIMATE, VARIANCE, SE, SE_PERCENT, PLOT_COUNT. With no grouping, a single grand-total row.

Example🔗

FIA forest-land area by county for Delaware 2020:

- id: 01890000-0000-0000-0000-000000000204
  name: fiadb.fullreport
  args:
    wc: "102020"
    snum: "2"
    sdenom: ""
    rselected: "County code and name"
    cselected: ""
    pselected: ""
    rtime: ""
    ctime: ""
    ptime: ""
    strFilter: ""
    FIAorRPA: ""
    estOnly: ""