System business rule specification specimen viewing - ESG-Project/documentation GitHub Wiki

← Home / Requirements / Business Rules

BR11 – Specimen Viewing

This business rule defines how users can view registered specimens in a table format, providing sorting, pagination, and search functionalities.

Rule Details

Field Content
Identification BR11
Business Rule Specimen Viewing
Description Displays specimen data in a sortable, paginated table by analysis, with search capabilities.
Source System Requirements
Priority Medium
Status Active

Implementation Details

  • A table displays specimen data for the selected analysis, including columns for Plot, Species, Family, CAP Mean, DBH, Height, Basal Area, Volume, and Registration Date.
  • Users can sort the table by any column.
  • The table supports pagination for efficient viewing of large datasets.
  • A search functionality allows filtering specimens by Species, Family, or Plot.
  • Specimens store CAP1…CAP6, from which the system automatically calculates:
    • ABI (Individual Basal Area – sum of CAP-based basal areas)
    • CAP Mean
    • DBH (DAP)
    • Basal Area in m²
    • Volume

📐 Calculation Rules

CR11.1 – ABI (Individual Basal Area)

Each specimen has up to six CAP measurements (CAP1…CAP6).
ABI corresponds to the sum of basal areas derived from each CAP: ABI = (CAP1²)/(4π) + (CAP2²)/(4π) + (CAP3²)/(4π) + (CAP4²)/(4π) + (CAP5²)/(4π) + (CAP6²)/(4π)

ABI is expressed in cm².

CR11.2 – CAP Mean

The mean CAP is calculated from ABI: CAP_mean = √( ABI × 4π )

CR11.3 – DBH (DAP) Conversion

DBH in centimeters: DBH(cm) = CAP_mean / π

DBH in meters: DBH(m) = DBH(cm) / 100

CR11.4 – Basal Area (G)

Basal area in square meters is derived from ABI: G(m²) = ABI / 10,000

CR11.5 – Volume

Tree volume is calculated as: Volume = G(m²) × Height Optional derived value: Volume³ = Volume × Volume × Volume

Related Components

  • Specimen List Table
  • Pagination Control
  • Sortable Column Headers
  • Search Input Field

History

Version Date Author Changes
1.0 2025-07-29 System Initial version

Notes

  • Basal Area, CAP Mean, DBH, and Volume are system-calculated, ensuring consistency.
  • Provides an overview of recorded data, aiding in data verification.
  • Enhances data accessibility and navigability for users.