Extract backbone embeddings from a fitted MoCo v2 encoder — foundation_moco_embed • edaphos

3.10.0

Reference
- Capstone — six pillars integrated
- Cross-pillar campaign
- Pilar 1 — Causal AI
- Causal backdoor on br_cerrado
- Causal on 1 095 real WoSIS profiles
- Causal-discovery trio (expert × LLM × data-driven)
- LLM-KG benchmark (Gemma 4 × GPT × Claude)
- Annotation workflow (pre-annotation + Shiny review)
- Pilar 2 — Physics-Informed ML
- Parametric ODE + Neural ODE
- Pilar 3 — 4D Pedometry
- ConvLSTM on synthetic cube
- Real MODIS + NASA POWER + EnKF
- Pilar 4 — Foundation Models
- SimCLR / MoCo embeddings
- Pilar 5 — Active Learning
- Hybrid policy + physics gate
- SoilGrids-BR live
- Pilar 6 — Quantum ML
- ZZFeatureMap + Q-KRR
- Cross-pillar bridges
- Pilar 1 × Pilar 4 — Foundation IVs
- Pilar 4 × Pilar 6 — Quantum-foundation kernel
- Unified infrastructure
- Unified uncertainty API
- Case — end-to-end Cerrado benchmark
- Releases
- v2.0.0 — Quantum kernel × Foundation (Pilar 4 × Pilar 6)
- v1.9.x — Foundation embeddings as causal IVs + Sargan/Cinelli-Hazlett
- v1.8.x — LLM benchmark infrastructure + Shiny annotation tool
- v1.7.x — Capstone vignette + native-query calibration + causal discovery
- Changelog

Returns the feature_dim backbone output of the query encoder (the projection head is by design discarded after pre-training, so the returned embedding is the reusable representation suitable for downstream DSM tasks). Set projection = TRUE to obtain the normalised projection-head output instead, which is useful when visualising the contrastive space.

Usage

foundation_moco_embed(object, patches, projection = FALSE)

Arguments

object: A edaphos_foundation_moco.
patches: Array (N, C, H, W).
projection: Logical; return L2-normalised projection outputs rather than backbone features.

Value

Numeric matrix (N, D) where D = feature_dim (or proj_dim if projection = TRUE).