phase: 4H
names:
  reference: MaleCNS-LIF-reference-v1
  runtime: MaleCNS-LIF-runtime-v1
  io_api: MaleCNS-BrainIO-v1
  activity_stream: MaleCNS-ActivityStream-v1
  plasticity_candidate: MaleCNS-DopaminePlasticity-v1-candidate
execution:
  mode: two-stage
  stage1_only_entrypoint: phase4h_audit.py
  require_stage1_pass_before_conditioning: true

paths:
  connectome_root: /data/digital-drosophila/datasets/male-cns-v1.0/processed/neuron-only
  model_root: /data/digital-drosophila/models/male-cns-lif/dopamine-plasticity-v1
  learned_root: /data/digital-drosophila/models/learned/phase4h
  experiment_root: /data/digital-drosophila/experiments/phase4h-dopamine-plasticity
  reference_root: /data/digital-drosophila/models/male-cns-lif/reference-v1
  runtime_root: /data/digital-drosophila/models/male-cns-lif/runtime-v1
  io_root: /data/digital-drosophila/models/male-cns-lif/io-v1
  phase4c_root: /data/digital-drosophila/experiments/phase4c-runtime
  phase4d_root: /data/digital-drosophila/experiments/phase4d-io
  phase4e_root: /data/digital-drosophila/experiments/phase4e-visual-calibration
  phase4f_root: /data/digital-drosophila/experiments/phase4f-retinotopic-vision
  phase4f_model_root: /data/digital-drosophila/models/male-cns-lif/visual-encoder-v1
  phase4g_root: /data/digital-drosophila/experiments/phase4g-frozen-interface
  phase4g_model_root: /data/digital-drosophila/models/male-cns-lif/frozen-interface-v1
  phase4g_learned_root: /data/digital-drosophila/models/learned/phase4g

expected_graph:
  neurons: 166700
  directed_edges: 25582938
  synaptic_contact_weight_sum: 124177617

model:
  dt_ms: 0.1
  membrane_tau_ms: 20.0
  synaptic_tau_ms: 5.0
  refractory_ms: 2.2
  resting_potential_mv: -52.0
  reset_potential_mv: -52.0
  threshold_mv: -45.0
  synaptic_delay_ms: 1.8
  w_syn_mv_per_anatomical_synapse: 0.275

sign_policy:
  neurotransmitter_sign: {acetylcholine: 1, gaba: -1, glutamate: -1, dopamine: 1, octopamine: 1, serotonin: 1, histamine: -1}
  unknown_sign: 0
  unclear_sign: 0

readout:
  bins_ms: [1, 5, 10, 20, 50, 100]

audit:
  exact_class_values:
    KC: Kenyon_Cell
    MBON: MBON
    DAN: DAN
  pam_type_prefix: PAM
  ppl1_type_prefix: PPL1
  compartment_source_field: annotation_instance
  compartment_parser: single_parenthesized_substring_verbatim
  require_exact_compartment_string_match: true
  candidate_requires_actual_kc_mbon_edge: true
  candidate_requires_actual_dan_mbon_edge: true
  candidate_requires_exact_dan_mbon_compartment_match: true
  do_not_infer_missing_compartment_from_type: true

plasticity:
  base_connectome_mode: read_only
  overlay_equation: effective_weight = base_weight + plastic_delta
  rule: delta_w = polarity_compartment * eta * D_compartment(t) * eligibility_ij(t)
  first_version_rule_family: compartment_specific_dopamine_gated_anti_hebbian_depression
  default_confirmed_compartment_polarity: -1
  unknown_compartment_policy: exclude_from_plastic_mask
  pam_ppl1_cluster_valence_policy: prohibited
  reward_interface_interpretation: artificial_unconditioned_signal_not_dopamine_concentration
  polarity_provenance:
    - https://pubmed.ncbi.nlm.nih.gov/26637800/
    - https://pubmed.ncbi.nlm.nih.gov/25535793/
    - https://www.nature.com/articles/s41586-024-07819-w
  eligibility_tau_ms: 1000.0
  eta_effective_mv: 0.00275
  min_effective_weight_mv: 0.0
  max_fractional_depression_per_edge: 0.25
  training_trials: 3
  d_magnitude: 1.0

conditioning:
  cs_population: olfactory
  cs_rate_hz: 50.0
  cs_duration_ms: 100.0
  cs_targets_per_identity: 64
  cs_identity_rule: sorted_neuron_idx_disjoint_halves
  appetitive_compartment_verbatim: "y5B'2a"
  appetitive_dan_type_required: PAM15
  aversive_compartment_verbatim: "y2a'1"
  aversive_dan_type_required: PPL103
  delayed_reward_ms: 50.0
  train_seeds: [48001, 48002, 48003, 48004, 48005]
  evaluation_seeds: [48101, 48102, 48103, 48104, 48105]
  protocols:
    - appetitive-conditioning
    - aversive-conditioning
    - reversal-learning
    - delayed-reward
    - retention
    - d-zero-control
    - random-reward-control
    - frozen-brain-control
  reward_interface_label: artificial_unconditioned_signal_interface

success_gate:
  require_all_frozen_checksums_pass: true
  require_phase4c_reference_spike_events_exact: true
  require_no_nan_inf_or_runaway: true
  require_minimum_seed_majority: 3
  require_appetitive_and_aversive_mbon_separation_gain: true
  require_downstream_separation_gain: true
  require_reversal_signature: true
  require_retention_signature: true
  controls_must_not_equal_conditioning_effect: true
  weight_change_alone_is_never_sufficient: true

device:
  required_name_substring: RTX 4090
  launcher_visible_gpu_uuid: GPU-79f3a85d-adce-7833-7003-6488140ca596

prohibitions:
  modify_phase1_to_phase4g: false
  conditioning_during_stage1: false
  weight_update_during_stage1: false
  infer_unknown_mapping: false
  train_base_brain: false