# arnofeinstein/neurofeedback-task architecture

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

- Interactive diagram: https://gitdiagram.com/arnofeinstein/neurofeedback-task
- Repository: https://github.com/arnofeinstein/neurofeedback-task

## Overview

This MATLAB project develops a macaque behavioral task offline, then provides a thin MonkeyLogic execution scaffold. The principal task workflow generates trial conditions, applies a rule to the sample direction, evaluates the response, and can simulate trials or sessions. The MonkeyLogic branch prepares trials and placeholder task objects for a timing-file skeleton, then maps outcomes into behavioral fields. A separate documented flow-and-export capability builds flow specifications, schemas, tables, validation, and exports. Relationships are limited to those stated in the README; source excerpts were unavailable, so internal call chains are not asserted.

Main entry points: [`core/simulate_trial.m`](https://github.com/arnofeinstein/neurofeedback-task/blob/main/core/simulate_trial.m) (Trial simulation), [`ml/sessionlog_to_table.m`](https://github.com/arnofeinstein/neurofeedback-task/blob/main/ml/sessionlog_to_table.m) (Session table), [`core/transform_rule.m`](https://github.com/arnofeinstein/neurofeedback-task/blob/main/core/transform_rule.m) (Rule transform), [`core/simulate_session.m`](https://github.com/arnofeinstein/neurofeedback-task/blob/main/core/simulate_session.m) (Session simulation)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_core["Core task logic"]
  node_params["Task parameters<br/>[default_params.m]"]
  node_trial_table["Trial generation"]
  node_rule_transform["Rule transform<br/>[transform_rule.m]"]
  node_choice_eval["Choice evaluation<br/>[evaluate_choice.m]"]
  node_angle_position["Angle geometry<br/>[angle_to_xy.m]"]
  node_default_agent["Default agent<br/>[default_agent.m]"]
end

subgraph group_simulation["Offline simulation"]
  node_trial_sim["Trial simulation<br/>[simulate_trial.m]"]
  node_session_sim["Session simulation<br/>[simulate_session.m]"]
end

subgraph group_monkeylogic["MonkeyLogic scaffold"]
  node_ml_userloop["Mode userloop<br/>[userloop.m]"]
  node_prepare_trial["Trial preparation<br/>[ml_prepare_trial.m]"]
  node_task_objects["Task objects"]
  node_timing_file["Timing skeleton<br/>[tf_rule_rdk.m]"]
  node_result_logging["Outcome mapping"]
end

subgraph group_flow_export["Flow and export"]
  node_timing_blueprint["Timing blueprint"]
  node_error_blueprint["Error blueprint"]
  node_trial_spec["Trial flow spec"]
  node_trial_flow["Trial flow runner<br/>[run_trial_flow.m]"]
  node_session_flow["Session flow runner<br/>[run_session_flow.m]"]
  node_behavior_schema["Behavior schema"]
  node_session_table["Session table"]
  node_table_validation["Table validation"]
  node_csv_export["CSV export"]
  node_export_pipeline["Final export"]
end

node_matlab_user(("Task developer"))

node_matlab_user -->|"runs offline"| node_trial_sim
node_matlab_user -->|"runs offline"| node_session_sim
node_matlab_user -->|"runs scaffold"| node_ml_userloop
node_trial_table -.->|"trial logic"| node_rule_transform
node_rule_transform -.->|"rule result"| node_choice_eval
node_trial_sim -.->|"evaluates response"| node_choice_eval
node_session_sim -.->|"simulates trials"| node_trial_sim
node_ml_userloop -->|"prepares trial"| node_prepare_trial
node_prepare_trial -.->|"builds objects"| node_task_objects
node_task_objects -->|"provides placeholders"| node_timing_file
node_timing_file -->|"maps outcomes"| node_result_logging
node_trial_flow -.->|"uses specification"| node_trial_spec
node_session_flow -.->|"runs trial flow"| node_trial_flow
node_session_table -.->|"aligns fields"| node_behavior_schema
node_table_validation -.->|"validates table"| node_session_table
node_csv_export -.->|"exports table"| node_session_table
node_export_pipeline -.->|"final export"| node_csv_export

click node_params "https://github.com/arnofeinstein/neurofeedback-task/blob/main/core/default_params.m"
click node_trial_table "https://github.com/arnofeinstein/neurofeedback-task/blob/main/core/build_trial_table.m"
click node_rule_transform "https://github.com/arnofeinstein/neurofeedback-task/blob/main/core/transform_rule.m"
click node_choice_eval "https://github.com/arnofeinstein/neurofeedback-task/blob/main/core/evaluate_choice.m"
click node_angle_position "https://github.com/arnofeinstein/neurofeedback-task/blob/main/core/angle_to_xy.m"
click node_default_agent "https://github.com/arnofeinstein/neurofeedback-task/blob/main/core/default_agent.m"
click node_trial_sim "https://github.com/arnofeinstein/neurofeedback-task/blob/main/core/simulate_trial.m"
click node_session_sim "https://github.com/arnofeinstein/neurofeedback-task/blob/main/core/simulate_session.m"
click node_ml_userloop "https://github.com/arnofeinstein/neurofeedback-task/blob/main/ml/userloop.m"
click node_prepare_trial "https://github.com/arnofeinstein/neurofeedback-task/blob/main/ml/ml_prepare_trial.m"
click node_task_objects "https://github.com/arnofeinstein/neurofeedback-task/blob/main/ml/ml_taskobjects_for_trial.m"
click node_timing_file "https://github.com/arnofeinstein/neurofeedback-task/blob/main/ml/tf_rule_rdk.m"
click node_result_logging "https://github.com/arnofeinstein/neurofeedback-task/blob/main/ml/ml_log_trial_result.m"
click node_timing_blueprint "https://github.com/arnofeinstein/neurofeedback-task/blob/main/ml/build_timing_blueprint.m"
click node_error_blueprint "https://github.com/arnofeinstein/neurofeedback-task/blob/main/ml/build_error_blueprint.m"
click node_trial_spec "https://github.com/arnofeinstein/neurofeedback-task/blob/main/ml/build_trial_flow_spec.m"
click node_trial_flow "https://github.com/arnofeinstein/neurofeedback-task/blob/main/ml/run_trial_flow.m"
click node_session_flow "https://github.com/arnofeinstein/neurofeedback-task/blob/main/ml/run_session_flow.m"
click node_behavior_schema "https://github.com/arnofeinstein/neurofeedback-task/blob/main/ml/build_behavior_schema.m"
click node_session_table "https://github.com/arnofeinstein/neurofeedback-task/blob/main/ml/sessionlog_to_table.m"
click node_table_validation "https://github.com/arnofeinstein/neurofeedback-task/blob/main/ml/validate_session_table.m"
click node_csv_export "https://github.com/arnofeinstein/neurofeedback-task/blob/main/ml/export_session_csv.m"
click node_export_pipeline "https://github.com/arnofeinstein/neurofeedback-task/blob/main/ml/final_export_pipeline.m"

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_params,node_trial_table,node_rule_transform,node_choice_eval,node_angle_position,node_default_agent toneBlue
class node_trial_sim,node_session_sim toneAmber
class node_ml_userloop,node_prepare_trial,node_task_objects,node_timing_file,node_result_logging toneMint
class node_timing_blueprint,node_error_blueprint,node_trial_spec,node_trial_flow,node_session_flow,node_behavior_schema,node_session_table,node_table_validation,node_csv_export,node_export_pipeline,node_matlab_user toneRose
```

## Components

### Core task logic

- [Task parameters](https://github.com/arnofeinstein/neurofeedback-task/blob/main/core/default_params.m): `core/default_params.m`
- [Trial generation](https://github.com/arnofeinstein/neurofeedback-task/blob/main/core/build_trial_table.m): `core/build_trial_table.m`
- [Rule transform](https://github.com/arnofeinstein/neurofeedback-task/blob/main/core/transform_rule.m): `core/transform_rule.m`
- [Choice evaluation](https://github.com/arnofeinstein/neurofeedback-task/blob/main/core/evaluate_choice.m): `core/evaluate_choice.m`
- [Angle geometry](https://github.com/arnofeinstein/neurofeedback-task/blob/main/core/angle_to_xy.m): `core/angle_to_xy.m`
- [Default agent](https://github.com/arnofeinstein/neurofeedback-task/blob/main/core/default_agent.m): `core/default_agent.m`

### Offline simulation

- [Trial simulation](https://github.com/arnofeinstein/neurofeedback-task/blob/main/core/simulate_trial.m): `core/simulate_trial.m`
- [Session simulation](https://github.com/arnofeinstein/neurofeedback-task/blob/main/core/simulate_session.m): `core/simulate_session.m`

### MonkeyLogic scaffold

- [Mode userloop](https://github.com/arnofeinstein/neurofeedback-task/blob/main/ml/userloop.m): `ml/userloop.m`
- [Trial preparation](https://github.com/arnofeinstein/neurofeedback-task/blob/main/ml/ml_prepare_trial.m): `ml/ml_prepare_trial.m`
- [Task objects](https://github.com/arnofeinstein/neurofeedback-task/blob/main/ml/ml_taskobjects_for_trial.m): `ml/ml_taskobjects_for_trial.m`
- [Timing skeleton](https://github.com/arnofeinstein/neurofeedback-task/blob/main/ml/tf_rule_rdk.m): `ml/tf_rule_rdk.m`
- [Outcome mapping](https://github.com/arnofeinstein/neurofeedback-task/blob/main/ml/ml_log_trial_result.m): `ml/ml_log_trial_result.m`

### Flow and export

- [Timing blueprint](https://github.com/arnofeinstein/neurofeedback-task/blob/main/ml/build_timing_blueprint.m): `ml/build_timing_blueprint.m`
- [Error blueprint](https://github.com/arnofeinstein/neurofeedback-task/blob/main/ml/build_error_blueprint.m): `ml/build_error_blueprint.m`
- [Trial flow spec](https://github.com/arnofeinstein/neurofeedback-task/blob/main/ml/build_trial_flow_spec.m): `ml/build_trial_flow_spec.m`
- [Trial flow runner](https://github.com/arnofeinstein/neurofeedback-task/blob/main/ml/run_trial_flow.m): `ml/run_trial_flow.m`
- [Session flow runner](https://github.com/arnofeinstein/neurofeedback-task/blob/main/ml/run_session_flow.m): `ml/run_session_flow.m`
- [Behavior schema](https://github.com/arnofeinstein/neurofeedback-task/blob/main/ml/build_behavior_schema.m): `ml/build_behavior_schema.m`
- [Session table](https://github.com/arnofeinstein/neurofeedback-task/blob/main/ml/sessionlog_to_table.m): `ml/sessionlog_to_table.m`
- [Table validation](https://github.com/arnofeinstein/neurofeedback-task/blob/main/ml/validate_session_table.m): `ml/validate_session_table.m`
- [CSV export](https://github.com/arnofeinstein/neurofeedback-task/blob/main/ml/export_session_csv.m): `ml/export_session_csv.m`
- [Final export](https://github.com/arnofeinstein/neurofeedback-task/blob/main/ml/final_export_pipeline.m): `ml/final_export_pipeline.m`

### Other components

- **Task developer**

## Connections

- Task developer → Trial simulation: runs offline (evidence: `README.md`)
- Task developer → Session simulation: runs offline (evidence: `README.md`)
- Task developer → Mode userloop: runs scaffold (evidence: `README.md`)
- Trial generation → Rule transform: trial logic
- Rule transform → Choice evaluation: rule result
- Trial simulation → Choice evaluation: evaluates response
- Session simulation → Trial simulation: simulates trials
- Mode userloop → Trial preparation: prepares trial (evidence: `README.md`)
- Trial preparation → Task objects: builds objects
- Task objects → Timing skeleton: provides placeholders (evidence: `README.md`)
- Timing skeleton → Outcome mapping: maps outcomes (evidence: `README.md`)
- Trial flow runner → Trial flow spec: uses specification
- Session flow runner → Trial flow runner: runs trial flow
- Session table → Behavior schema: aligns fields
- Table validation → Session table: validates table
- CSV export → Session table: exports table
- Final export → CSV export: final export
