# anticipatedd/anticipatedd architecture

> Architecture diagram of the GitHub repository anticipatedd/anticipatedd, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-09-27). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/anticipatedd/anticipatedd
- Repository: https://github.com/anticipatedd/anticipatedd

## Overview

This repository is primarily a collection of AlphaNova cross-sectional signal submissions, not the Vane-Guard RAG platform described in the profile README. The principal workflow is an evaluator supplying historical features and targets to a selected predictor, then requesting cross-sectionally de-meaned asset signals. The graph highlights representative ridge-based and factor-based approaches, plus the separate Ames housing experiment. Several submission files are near-duplicates; their unsampled details and exact evaluator wiring are not inferred.

Main entry points: [`predictor.py`](https://github.com/anticipatedd/anticipatedd/blob/main/predictor.py) (Predictor interface), [`latest_submission.py`](https://github.com/anticipatedd/anticipatedd/blob/main/latest_submission.py) (Latest ridge predictor), [`my_submission.py`](https://github.com/anticipatedd/anticipatedd/blob/main/my_submission.py) (Ridge predictor variant), [`FINAL_SUBMISSION_MyPredictor_ELITE.py`](https://github.com/anticipatedd/anticipatedd/blob/main/FINAL_SUBMISSION_MyPredictor_ELITE.py) (Elite ridge variant)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_contract["Predictor contract"]
  node_predictor_api["Predictor interface<br/>[predictor.py]"]
end

subgraph group_signals["Signal submissions"]
  node_latest["Latest ridge predictor"]
  node_my_submission["Ridge predictor variant<br/>[my_submission.py]"]
  node_elite["Elite ridge variant"]
  node_final["Final ridge variant"]
  node_alpha["AlphaNova ridge"]
  node_cycle2["Cycle 2 allocation"]
  node_factor["Factor ensemble<br/>[submission.py]"]
  node_amonra["AmonRa predictor<br/>[submission.py]"]
  node_signal["Demeaned signal"]
end

subgraph group_experiments["Separate experiment"]
  node_housing_pipeline["Housing regression pipeline<br/>[notebookbddot.py]"]
  node_housing_predictions["Price predictions"]
end

node_evaluator(("Competition evaluator"))
node_housing_data["Housing CSV data"]

node_evaluator -->|"supplies inputs"| node_predictor_api
node_predictor_api -->|"contract for"| node_latest
node_predictor_api -->|"contract for"| node_my_submission
node_predictor_api -->|"contract for"| node_alpha
node_predictor_api -->|"contract for"| node_cycle2
node_latest -->|"returns signal"| node_signal
node_my_submission -->|"returns signal"| node_signal
node_alpha -->|"returns signal"| node_signal
node_cycle2 -->|"returns positions"| node_signal
node_evaluator -.->|"selects candidate"| node_elite
node_evaluator -.->|"selects candidate"| node_final
node_elite -->|"produces signal"| node_signal
node_final -->|"produces signal"| node_signal
node_evaluator -.->|"selects candidate"| node_factor
node_evaluator -.->|"selects candidate"| node_amonra
node_factor -->|"produces signal"| node_signal
node_amonra -->|"produces signal"| node_signal
node_housing_data -->|"read by"| node_housing_pipeline
node_housing_pipeline -->|"blends predictions"| node_housing_predictions

click node_predictor_api "https://github.com/anticipatedd/anticipatedd/blob/main/predictor.py"
click node_latest "https://github.com/anticipatedd/anticipatedd/blob/main/latest_submission.py"
click node_my_submission "https://github.com/anticipatedd/anticipatedd/blob/main/my_submission.py"
click node_elite "https://github.com/anticipatedd/anticipatedd/blob/main/FINAL_SUBMISSION_MyPredictor_ELITE.py"
click node_final "https://github.com/anticipatedd/anticipatedd/blob/main/FINAL_SUBMISSION_MyPredictor.py"
click node_alpha "https://github.com/anticipatedd/anticipatedd/blob/main/alphanova_signal_submission.py"
click node_cycle2 "https://github.com/anticipatedd/anticipatedd/blob/main/Season1Cyc2_submission.py"
click node_factor "https://github.com/anticipatedd/anticipatedd/blob/main/submission.py"
click node_amonra "https://github.com/anticipatedd/anticipatedd/blob/main/submission.py"
click node_housing_pipeline "https://github.com/anticipatedd/anticipatedd/blob/main/harigov63/notebookbddot.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_predictor_api toneBlue
class node_latest,node_my_submission,node_elite,node_final,node_alpha,node_cycle2,node_factor,node_amonra,node_signal toneAmber
class node_housing_pipeline,node_housing_predictions toneMint
class node_evaluator,node_housing_data toneIndigo
```

## Components

### Predictor contract

- [Predictor interface](https://github.com/anticipatedd/anticipatedd/blob/main/predictor.py): `predictor.py`

### Signal submissions

- [Latest ridge predictor](https://github.com/anticipatedd/anticipatedd/blob/main/latest_submission.py): `latest_submission.py`
- [Ridge predictor variant](https://github.com/anticipatedd/anticipatedd/blob/main/my_submission.py): `my_submission.py`
- [Elite ridge variant](https://github.com/anticipatedd/anticipatedd/blob/main/FINAL_SUBMISSION_MyPredictor_ELITE.py): `FINAL_SUBMISSION_MyPredictor_ELITE.py`
- [Final ridge variant](https://github.com/anticipatedd/anticipatedd/blob/main/FINAL_SUBMISSION_MyPredictor.py): `FINAL_SUBMISSION_MyPredictor.py`
- [AlphaNova ridge](https://github.com/anticipatedd/anticipatedd/blob/main/alphanova_signal_submission.py): `alphanova_signal_submission.py`
- [Cycle 2 allocation](https://github.com/anticipatedd/anticipatedd/blob/main/Season1Cyc2_submission.py): `Season1Cyc2_submission.py`
- [Factor ensemble](https://github.com/anticipatedd/anticipatedd/blob/main/submission.py): `submission.py`
- [AmonRa predictor](https://github.com/anticipatedd/anticipatedd/blob/main/submission.py): `submission.py`
- **Demeaned signal**

### Separate experiment

- [Housing regression pipeline](https://github.com/anticipatedd/anticipatedd/blob/main/harigov63/notebookbddot.py): `harigov63/notebookbddot.py`
- **Price predictions**

### Other components

- **Competition evaluator**
- **Housing CSV data**

## Connections

- Competition evaluator → Predictor interface: supplies inputs
- Predictor interface → Latest ridge predictor: contract for
- Predictor interface → Ridge predictor variant: contract for
- Predictor interface → AlphaNova ridge: contract for
- Predictor interface → Cycle 2 allocation: contract for
- Latest ridge predictor → Demeaned signal: returns signal
- Ridge predictor variant → Demeaned signal: returns signal
- AlphaNova ridge → Demeaned signal: returns signal
- Cycle 2 allocation → Demeaned signal: returns positions
- Competition evaluator → Elite ridge variant: selects candidate
- Competition evaluator → Final ridge variant: selects candidate
- Elite ridge variant → Demeaned signal: produces signal
- Final ridge variant → Demeaned signal: produces signal
- Competition evaluator → Factor ensemble: selects candidate
- Competition evaluator → AmonRa predictor: selects candidate
- Factor ensemble → Demeaned signal: produces signal
- AmonRa predictor → Demeaned signal: produces signal
- Housing CSV data → Housing regression pipeline: read by
- Housing regression pipeline → Price predictions: blends predictions