femic

Guides

  • Guides
    • Pipeline Walkthrough
      • Purpose
      • End-to-End Flow
      • Stage Boundaries
      • Key Assumptions
      • Operator Interpretation Callouts
      • Primary Sources
    • Developer Environment Bootstrap (Fresh Clone)
      • Purpose
      • Copy-Paste Bootstrap Scripts
      • 1) Create and activate a local .venv
      • 2) Install editable dev dependencies
      • 3) Verify runtime tools are available
      • 4) Initialize submodules and materialize annex data
      • 5) Export the external data root and run preflight
      • Related Guides
    • VS Code and Coding-Agent Onboarding
      • Purpose
      • Use This Guide For
      • Minimum Local Setup
      • Windows VS Code/Codex Recovery: Broken Local File Links
      • VS Code Workspace Basics
      • What the Coding Agent Is Good At
      • What Still Needs Human Supervision
      • Prompting Style That Works Well
      • Scoping Rules for Large Tasks
      • Recommended Human Review Loop
      • GitHub Issue Workflow Hygiene
      • FEMIC-Specific Things to Watch For
      • Current Proprietary-Tool Seams
      • Patchworks Overlay Reminder
      • Suggested First Session for a New Contributor
      • Patchworks model rule of thumb
      • Looking Ahead
      • Related Guides
    • Deployment Instance Setup
      • Create an Instance
      • Visible User Workspace Root
      • Canonical In-Repo Reference Instance (Maintainers)
      • BC VRI Auto-Download
      • Installed-Package Preflight Check
      • Instance Root Resolution
      • Registry-Backed Patchworks Variants
      • Canonical K3Z Example Instance Repository
      • Canonical TSA29 Example Instance Repository
      • Working With Bundled Example Instances Under external/
      • Bundled Example Instance Amend/Rebuild Loop
      • Parent Repo vs Submodule Repo
      • Contributor Baseline for New Instance Repositories
      • Reference Instance Release Gate Evidence
    • Rebuild Repro Contract
      • Purpose
      • Contract Sources
      • Expected Operator Workflow
      • Required Evidence Artifacts
      • Failure Classes
      • Contributor Policy (Mandatory for New Instance Repos)
      • Next Guides
    • How to Author a New Instance Rebuild Spec
      • Purpose
      • Start from Template
      • Core Sections
      • Minimal Copy-Ready Example
      • Step Authoring Rules
      • Invariant Authoring Rules
      • K3Z Reference Pattern
      • Dry-Run and Execute
    • How to Interpret Rebuild Reports and Regressions
      • Report Location
      • Step Outcomes
      • Invariant Results
      • Baseline and Allowlist Diffs
      • Regression Gate
      • Evidence Trend Drift Across Releases
      • Triage Workflow
      • Common Patterns
    • Data Access Inventory
      • Authoritative Registry
      • Key Dataset Families
      • Checksum Policy
      • DataLad Mirror Scope
      • BC Data Catalogue Discovery
      • TSR Intelligence Workflow
    • BC Data Catalogue Discovery
      • Purpose
      • Minimal Workflow
      • Concrete Examples
      • Good-Citizen Guardrails
      • Worked Example: F_OWN to a Local GeoPackage
      • Batch Input from a Query File
      • PowerShell Notes
      • Classification Buckets
      • Service Automation Hints
      • AOI-Scoped WFS Fetch
      • DWDS / FGDB Fallback
      • Worked Example: TSA29 Query File to Local Layers
      • Manifest Output
      • Promotion Path
      • bcdata Attribution
      • Related References
    • TSR Intelligence Workflow
      • Purpose
      • Canonical vs Local Outputs
      • Minimal One-TSA Workflow
      • Reviewed Adoption Workflow
      • Worked Example: TSA29 Source Layers and THLB
      • Convergence And Reproducibility Contract
      • AOI Scope Guardrail
      • Windows PowerShell Notes
      • Using Extracted Source Layers with BCDC Discovery
      • Agent Workflow Notes
      • Current Boundaries
      • Related References
    • Document Figure Recovery
      • Install
      • Corpus Layout
      • Prepare A Corpus
      • Register A Recovered Table
      • Review Gates
      • TFL 6 MP11 Pilot
    • FreshForge Provider Integration
      • Purpose
      • Install
      • Finding Available Workflows
      • Provider Discovery
      • Materialization Provider
      • Generic Workflow Example
      • Namespace-Aware Artifacts
      • Relationship To FEMIC Execution
      • Instance Workflow Ownership
      • Boundaries
      • API
    • TSR THLB Reconstruction Ladder
      • Purpose
      • Why AFLB and THLB Matter
      • The Reconstruction Ladder
      • Current FEMIC Execution Modes
      • Fallback and Review Paths
      • Comparison Contract
      • THLB Accounting Directives
      • Worked TSA29 Read
      • How This Guide Fits the Other Docs
    • GitHub + DataLad + Arbutus Pattern
      • Short Version
      • What FEMIC Wraps Today
      • What Stays in Runbooks on Purpose
      • How Collaborators Normally Consume the Data
      • How the Coding Agent Fits In
      • How to Copy This Pattern into Another Project
      • If You Only Read 6 Files
      • Bottom Line
    • Windows Arbutus Auth Workflow
      • User-local files
      • Shared env contract
      • Profile registry
      • Status marker
      • Fresh bootstrap
      • Shell loading
      • Status checks
      • Relationship to prep validate-case
      • Instance publication vs public-data mirror
    • Public Data Mirror Runbook
      • Scope
      • Maintainer Workflow (Create/Publish Mirror Repo)
      • Collaborator Workflow (Clone/Get/Update)
      • Windows Notes
      • Acceptance Checks
    • Case Onboarding Template
      • Template Files
      • Onboarding Workflow
      • Required Input Checklist
      • Acceptance Criteria for Onboarded Case
      • K3Z Example Instance Baseline
      • TSA29 Example Instance Baseline
      • Working With a Local Coding Agent
    • Stage 00: Data Prep and Inventory Conditioning
      • Scope
      • Inputs
      • Core Processing Responsibilities
      • THLB interpretation note
      • Checkpoint Semantics
      • Assumptions
      • Outputs Consumed by Stage 01a
      • ArcRasterRescue Workflow Contract
      • Primary Legacy Notebook Coverage
    • Stage 01a: Strata, VDYP Curves, and TIPSY Input Generation
      • Scope
      • Key Workflow Steps
      • Selected-AU Curve-Family Contract
      • VDYP Fitting and SI Splits
      • TIPSY Input Boundary
      • Operator QA Checklist
      • Known Failure Signatures
      • Primary Legacy Notebook Coverage
      • K3Z Teaching Baseline Notes
      • Linux Source-Checkout Prerequisites
      • Known-Good Windows K3Z Hand-Off
      • Curve Rescue Guard
    • Stage 01b: Post-TIPSY Integration and Comparison
      • Scope
      • Required Input
      • Freshness guard
      • Core Responsibilities
      • Optional TSR Yield Assumptions
      • Interpretation Guide
      • Exit Criteria
      • Primary Legacy Notebook Coverage
      • Linux Source-Checkout Prerequisites
      • Known-Good Windows K3Z Resume Path
    • BTC and FAN$IER Runtime and Extraction
      • Purpose
      • BTC: Supported Unattended Runtime Seam
      • BTC /No_GUI Status
      • BTC Indicator Banks
      • FAN$IER: Tracked FEMIC Surfaces
      • Practical FAN$IER Lanes
      • Related References
    • Model Input Bundle and Export Workflow
      • Bundle Artifacts
      • AFLB Stand Universe and THLB/NTHLB Semantics
      • Selected-AU and Remap Semantics
      • Patchworks Export
      • Woodstock Export
      • Dual-Fork Export (Patchworks + Woodstock + Optional ws3 Smoke)
      • Release Packaging Export
      • Assumptions
    • Patchworks Variant and Scenario Management
      • Purpose
      • Registry Shape
      • Read-Only Inspection Flows
      • Materialization Consent Surface
      • Variant Launch Flows
      • Scenario Sets
      • User Overlay Management
      • Related References
    • Diagnostics Interpretation Playbook
      • Strata Diagnostics (strata-*.png)
      • VDYP Fit Diagnostics (vdyp_fitdiag_*.png)
      • TIPSY vs VDYP Overlays (tipsy_vdyp_*.png)
      • Escalation Path
    • Troubleshooting and Recovery Cookbook
      • Common Issues
    • Known Limitations and Human-in-the-Loop Boundaries
      • TIPSY Boundary
      • FAN$IER Boundary
      • Data Vendor/Format Constraints
      • Modeling Limitations
      • Documentation Scope Boundary
    • Patchworks Under Wine
      • Prerequisites
      • Config File
      • CLI Workflow
      • Generated Runtime Artifacts
      • Notes
    • UBC VPN and License Connectivity
      • Primary Topology
      • CLI OpenConnect Pattern
      • Diagnostic Steps
      • Failure Signatures
      • License Reachability Ownership
      • Fallback Path
    • Geospatial and Runtime Bootstrap
      • Why This Matters
      • Authoritative Platform Runtime Surfaces
      • Core Executables and Services
      • Windows Bootstrap Ritual
      • Linux Bootstrap Ritual
      • DataLad / git-annex Smoke Checks
      • Verify Runtime Readiness
      • Troubleshooting
    • Cross-Platform Runtime Smoke and Acceptance
      • Purpose
      • Platform-Specific Runtime Rituals
      • Windows Smoke Workflow
      • Linux Parity Workflow
      • Acceptance Criteria
      • What Should Match Across Platforms
      • What May Differ Across Platforms
      • Evidence to Keep
      • Related Guides
    • PyPI Release Runbook
      • Pre-release prerequisites
      • Packaging and deterministic wheel checks
      • Current known limitation
      • TestPyPI publication and smoke
      • Production PyPI publication
      • Post-release traceability checklist
      • Trusted publishing troubleshooting
    • Legacy Notebook Traceability
      • Coverage Inventory
      • Coverage Matrix Fields
      • Retired Guidance
      • Notebook Output Cleanup Policy
    • Sphinx Template Baseline
      • Canonical Reference
      • Required Baseline Components
      • Alignment Targets
      • K3Z Content-Depth Guardrail

Sample Models

  • Sample Models
    • K3Z Example Instance (Pointer)
      • Purpose
      • Canonical Student Docs
      • Standalone K3Z Coverage Map
      • Submodule Sync Commands
      • FEMIC-Local Integration Notes
    • TSA29 Example Instance (Pointer)
      • Purpose
      • Canonical Student Docs
      • Submodule Sync Commands
      • FEMIC-Local Integration Notes
    • MKRF Example Instance (Pointer)
      • Purpose
      • Canonical MKRF Docs
      • Current Scope Boundary
      • Commercial thinning follow-up
      • Current v0 checkpoint signal
      • Submodule Sync Commands
      • FEMIC-Local Integration Notes
    • TFL 6 Teaching Instance (Pointer)
      • Purpose
      • Current Status
      • Canonical Student Docs
      • Standalone TFL 6 Coverage Map
      • Submodule Sync Commands
      • FEMIC-Local Integration Notes
      • Selected-AU Curve-Family Reminder
      • Publication Boundary
    • K3Z Metadata and Lineage
      • Scope
      • Inventory: Upstream Sources -> Model Artifacts
      • Build-Lineage Chain
      • Component-Level Notes
      • Provenance Versioning Policy
      • Acceptance Checklist for Lineage Updates
    • MKRF Metadata and Lineage
      • Scope
      • Current Artifact Families
      • Canonical Build-Lineage Chain
      • Retained PoC / Legacy Reference Chain
      • Accepted Benchmark Result
      • Current Boundary
      • Accepted Legacy-Only Seams

Reference

  • Technical Contracts
    • How to use this section
    • Contract Pages
      • Patchworks Model Semantics
      • Repo and Runtime Invariants
      • Instance and Data Roots
      • Instance Extension Boundaries
      • Stage Boundaries and Canonical Artifacts
      • Recovery and External Runtime Boundaries
  • API Reference
    • API contract
    • How to use this reference
    • Current limitation
      • FEMIC Modules
  • CLI Reference
    • Top-Level Command
    • Options
    • Commands
    • Run
    • Document Ingestion
    • Pipelines
    • Prep
    • VDYP
    • TSA
    • TIPSY
    • Data
    • FAN$IER
    • Data
    • TSR
    • Export
    • Patchworks Runtime
    • Instance Workspace
  • Patchworks Export Contract
    • Patchworks semantics guardrail
    • ForestModel XML requirements
    • Species-wise yield curves
    • Seral-stage attributes (optional)
    • Retention modulator (optional per fragment)
    • Fragments shapefile requirements
    • CLI usage
  • Woodstock Compatibility Export
    • CLI usage
  • Run Config Profile
    • Schema
    • Precedence
    • Compatibility note
    • Example
  • Nemora Task Map (Draft)
  • Nemora Upstream Candidates (Draft)
femic
  • Overview: module code

All modules for which code is available

  • femic.bcdc_catalog
  • femic.bcdc_dwds
  • femic.bcdc_fetch
  • femic.cli.main
  • femic.document_figures
  • femic.fansier_reporting
  • femic.fansier_runtime
  • femic.fansier_workflow
  • femic.fmg.patchworks
  • femic.freshforge
  • femic.freshforge_materialization
  • femic.geospatial_preflight
  • femic.instance_bootstrap
  • femic.instance_context
  • femic.patchworks_runtime
  • femic.patchworks_variants
  • femic.pipeline.bundle
  • femic.pipeline.io
  • femic.pipeline.legacy_runtime
  • femic.pipeline.manifest
  • femic.pipeline.siteprod
  • femic.pipeline.tipsy
  • femic.pipeline.vdyp_stage
  • femic.rebuild_baseline
  • femic.rebuild_invariants
  • femic.rebuild_runner
  • femic.rebuild_spec
  • femic.release_packaging
  • femic.tsr_catalog.adjudication
  • femic.tsr_catalog.cache
  • femic.tsr_catalog.crawl
  • femic.tsr_catalog.extract
  • femic.tsr_catalog.overlay
  • femic.tsr_catalog.recipes
  • femic.tsr_catalog.report
  • femic.tsr_catalog.source_overrides
  • femic.tsr_catalog.step13_attributes
  • femic.workflows.legacy

© Copyright .

Built with Sphinx using a theme provided by Read the Docs.