bergson 2.2.3__tar.gz → 2.3.0__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (180) hide show
  1. {bergson-2.2.3 → bergson-2.3.0}/PKG-INFO +4 -4
  2. {bergson-2.2.3 → bergson-2.3.0}/README.md +3 -3
  3. {bergson-2.2.3 → bergson-2.3.0}/bergson/__init__.py +1 -1
  4. {bergson-2.2.3 → bergson-2.3.0}/bergson/build.py +10 -2
  5. {bergson-2.2.3 → bergson-2.3.0}/bergson/config/config.py +10 -1
  6. {bergson-2.2.3 → bergson-2.3.0}/bergson/hessians/shampoo.py +8 -7
  7. bergson-2.3.0/bergson/utils/batch_size.py +260 -0
  8. {bergson-2.2.3 → bergson-2.3.0}/bergson/utils/worker_utils.py +27 -11
  9. {bergson-2.2.3 → bergson-2.3.0}/bergson.egg-info/PKG-INFO +4 -4
  10. {bergson-2.2.3 → bergson-2.3.0}/bergson.egg-info/SOURCES.txt +1 -0
  11. {bergson-2.2.3 → bergson-2.3.0}/pyproject.toml +1 -1
  12. {bergson-2.2.3 → bergson-2.3.0}/tests/test_advantages.py +55 -0
  13. bergson-2.3.0/tests/test_auto_batch_size.py +90 -0
  14. bergson-2.2.3/bergson/utils/batch_size.py +0 -309
  15. {bergson-2.2.3 → bergson-2.3.0}/LICENSE +0 -0
  16. {bergson-2.2.3 → bergson-2.3.0}/bergson/__main__.py +0 -0
  17. {bergson-2.2.3 → bergson-2.3.0}/bergson/approx_unrolling/adam_preconditioner.py +0 -0
  18. {bergson-2.2.3 → bergson-2.3.0}/bergson/approx_unrolling/approx_unrolling_math.py +0 -0
  19. {bergson-2.2.3 → bergson-2.3.0}/bergson/approx_unrolling/pipeline.py +0 -0
  20. {bergson-2.2.3 → bergson-2.3.0}/bergson/approx_unrolling/precompute_checkpoints.py +0 -0
  21. {bergson-2.2.3 → bergson-2.3.0}/bergson/approx_unrolling/segment_aggregation.py +0 -0
  22. {bergson-2.2.3 → bergson-2.3.0}/bergson/approx_unrolling/train_cfg_io.py +0 -0
  23. {bergson-2.2.3 → bergson-2.3.0}/bergson/builder.py +0 -0
  24. {bergson-2.2.3 → bergson-2.3.0}/bergson/cli/__init__.py +0 -0
  25. {bergson-2.2.3 → bergson-2.3.0}/bergson/cli/commands.py +0 -0
  26. {bergson-2.2.3 → bergson-2.3.0}/bergson/cli/trackstar.py +0 -0
  27. {bergson-2.2.3 → bergson-2.3.0}/bergson/cli/trak.py +0 -0
  28. {bergson-2.2.3 → bergson-2.3.0}/bergson/collection.py +0 -0
  29. {bergson-2.2.3 → bergson-2.3.0}/bergson/collector/__init__.py +0 -0
  30. {bergson-2.2.3 → bergson-2.3.0}/bergson/collector/collector.py +0 -0
  31. {bergson-2.2.3 → bergson-2.3.0}/bergson/collector/dist_autocorrelation_gradient_collector.py +0 -0
  32. {bergson-2.2.3 → bergson-2.3.0}/bergson/collector/gradient_collectors.py +0 -0
  33. {bergson-2.2.3 → bergson-2.3.0}/bergson/collector/in_memory_collector.py +0 -0
  34. {bergson-2.2.3 → bergson-2.3.0}/bergson/collector/projection_matrix.py +0 -0
  35. {bergson-2.2.3 → bergson-2.3.0}/bergson/config/__init__.py +0 -0
  36. {bergson-2.2.3 → bergson-2.3.0}/bergson/config/config_io.py +0 -0
  37. {bergson-2.2.3 → bergson-2.3.0}/bergson/config/validation.py +0 -0
  38. {bergson-2.2.3 → bergson-2.3.0}/bergson/data.py +0 -0
  39. {bergson-2.2.3 → bergson-2.3.0}/bergson/diagnose.py +0 -0
  40. {bergson-2.2.3 → bergson-2.3.0}/bergson/distributed.py +0 -0
  41. {bergson-2.2.3 → bergson-2.3.0}/bergson/format.py +0 -0
  42. {bergson-2.2.3 → bergson-2.3.0}/bergson/gradients.py +0 -0
  43. {bergson-2.2.3 → bergson-2.3.0}/bergson/hessians/apply_hessian.py +0 -0
  44. {bergson-2.2.3 → bergson-2.3.0}/bergson/hessians/astra.py +0 -0
  45. {bergson-2.2.3 → bergson-2.3.0}/bergson/hessians/autocorrelation.py +0 -0
  46. {bergson-2.2.3 → bergson-2.3.0}/bergson/hessians/eigenvectors.py +0 -0
  47. {bergson-2.2.3 → bergson-2.3.0}/bergson/hessians/hessian_approximations.py +0 -0
  48. {bergson-2.2.3 → bergson-2.3.0}/bergson/hessians/inversion.py +0 -0
  49. {bergson-2.2.3 → bergson-2.3.0}/bergson/hessians/kfac.py +0 -0
  50. {bergson-2.2.3 → bergson-2.3.0}/bergson/hessians/pipeline.py +0 -0
  51. {bergson-2.2.3 → bergson-2.3.0}/bergson/hessians/preconditioner.py +0 -0
  52. {bergson-2.2.3 → bergson-2.3.0}/bergson/hessians/sharded_computation.py +0 -0
  53. {bergson-2.2.3 → bergson-2.3.0}/bergson/hessians/tkfac.py +0 -0
  54. {bergson-2.2.3 → bergson-2.3.0}/bergson/huggingface.py +0 -0
  55. {bergson-2.2.3 → bergson-2.3.0}/bergson/magic/__init__.py +0 -0
  56. {bergson-2.2.3 → bergson-2.3.0}/bergson/magic/cli.py +0 -0
  57. {bergson-2.2.3 → bergson-2.3.0}/bergson/magic/config.py +0 -0
  58. {bergson-2.2.3 → bergson-2.3.0}/bergson/magic/data_stream.py +0 -0
  59. {bergson-2.2.3 → bergson-2.3.0}/bergson/magic/dtensor_patch.py +0 -0
  60. {bergson-2.2.3 → bergson-2.3.0}/bergson/magic/fsdp.py +0 -0
  61. {bergson-2.2.3 → bergson-2.3.0}/bergson/magic/grad_accum.py +0 -0
  62. {bergson-2.2.3 → bergson-2.3.0}/bergson/magic/metasmoothness.py +0 -0
  63. {bergson-2.2.3 → bergson-2.3.0}/bergson/magic/optim.py +0 -0
  64. {bergson-2.2.3 → bergson-2.3.0}/bergson/magic/rtl_tqdm.py +0 -0
  65. {bergson-2.2.3 → bergson-2.3.0}/bergson/magic/score_plot.py +0 -0
  66. {bergson-2.2.3 → bergson-2.3.0}/bergson/magic/shard_load.py +0 -0
  67. {bergson-2.2.3 → bergson-2.3.0}/bergson/magic/swap.py +0 -0
  68. {bergson-2.2.3 → bergson-2.3.0}/bergson/magic/trainer.py +0 -0
  69. {bergson-2.2.3 → bergson-2.3.0}/bergson/moe.py +0 -0
  70. {bergson-2.2.3 → bergson-2.3.0}/bergson/process_autocorrelation.py +0 -0
  71. {bergson-2.2.3 → bergson-2.3.0}/bergson/process_grads.py +0 -0
  72. {bergson-2.2.3 → bergson-2.3.0}/bergson/query/__init__.py +0 -0
  73. {bergson-2.2.3 → bergson-2.3.0}/bergson/query/attributor.py +0 -0
  74. {bergson-2.2.3 → bergson-2.3.0}/bergson/query/faiss_index.py +0 -0
  75. {bergson-2.2.3 → bergson-2.3.0}/bergson/query/query_index.py +0 -0
  76. {bergson-2.2.3 → bergson-2.3.0}/bergson/recall/__init__.py +0 -0
  77. {bergson-2.2.3 → bergson-2.3.0}/bergson/recall/facts.py +0 -0
  78. {bergson-2.2.3 → bergson-2.3.0}/bergson/recall/generate.py +0 -0
  79. {bergson-2.2.3 → bergson-2.3.0}/bergson/recall/recall.py +0 -0
  80. {bergson-2.2.3 → bergson-2.3.0}/bergson/score/__init__.py +0 -0
  81. {bergson-2.2.3 → bergson-2.3.0}/bergson/score/candidates.py +0 -0
  82. {bergson-2.2.3 → bergson-2.3.0}/bergson/score/output_influence.py +0 -0
  83. {bergson-2.2.3 → bergson-2.3.0}/bergson/score/score.py +0 -0
  84. {bergson-2.2.3 → bergson-2.3.0}/bergson/score/score_writer.py +0 -0
  85. {bergson-2.2.3 → bergson-2.3.0}/bergson/score/scorer.py +0 -0
  86. {bergson-2.2.3 → bergson-2.3.0}/bergson/utils/__init__.py +0 -0
  87. {bergson-2.2.3 → bergson-2.3.0}/bergson/utils/csv_writer.py +0 -0
  88. {bergson-2.2.3 → bergson-2.3.0}/bergson/utils/gradcheck.py +0 -0
  89. {bergson-2.2.3 → bergson-2.3.0}/bergson/utils/load_from_optimizer.py +0 -0
  90. {bergson-2.2.3 → bergson-2.3.0}/bergson/utils/logger.py +0 -0
  91. {bergson-2.2.3 → bergson-2.3.0}/bergson/utils/logging.py +0 -0
  92. {bergson-2.2.3 → bergson-2.3.0}/bergson/utils/math.py +0 -0
  93. {bergson-2.2.3 → bergson-2.3.0}/bergson/utils/peft.py +0 -0
  94. {bergson-2.2.3 → bergson-2.3.0}/bergson/utils/step_state.py +0 -0
  95. {bergson-2.2.3 → bergson-2.3.0}/bergson/utils/trainer_export.py +0 -0
  96. {bergson-2.2.3 → bergson-2.3.0}/bergson/utils/utils.py +0 -0
  97. {bergson-2.2.3 → bergson-2.3.0}/bergson/validate.py +0 -0
  98. {bergson-2.2.3 → bergson-2.3.0}/bergson.egg-info/dependency_links.txt +0 -0
  99. {bergson-2.2.3 → bergson-2.3.0}/bergson.egg-info/entry_points.txt +0 -0
  100. {bergson-2.2.3 → bergson-2.3.0}/bergson.egg-info/requires.txt +0 -0
  101. {bergson-2.2.3 → bergson-2.3.0}/bergson.egg-info/top_level.txt +0 -0
  102. {bergson-2.2.3 → bergson-2.3.0}/setup.cfg +0 -0
  103. {bergson-2.2.3 → bergson-2.3.0}/tests/test_adam_state_loading.py +0 -0
  104. {bergson-2.2.3 → bergson-2.3.0}/tests/test_approx_unrolling_checkpoint_parse.py +0 -0
  105. {bergson-2.2.3 → bergson-2.3.0}/tests/test_attention_head_normalizers.py +0 -0
  106. {bergson-2.2.3 → bergson-2.3.0}/tests/test_attribute_tokens.py +0 -0
  107. {bergson-2.2.3 → bergson-2.3.0}/tests/test_attributor.py +0 -0
  108. {bergson-2.2.3 → bergson-2.3.0}/tests/test_bank_loss_cache.py +0 -0
  109. {bergson-2.2.3 → bergson-2.3.0}/tests/test_banked_model_loading.py +0 -0
  110. {bergson-2.2.3 → bergson-2.3.0}/tests/test_batch_size_invariance.py +0 -0
  111. {bergson-2.2.3 → bergson-2.3.0}/tests/test_build.py +0 -0
  112. {bergson-2.2.3 → bergson-2.3.0}/tests/test_builder.py +0 -0
  113. {bergson-2.2.3 → bergson-2.3.0}/tests/test_candidates.py +0 -0
  114. {bergson-2.2.3 → bergson-2.3.0}/tests/test_ckpt_avg_query_grads.py +0 -0
  115. {bergson-2.2.3 → bergson-2.3.0}/tests/test_cli.py +0 -0
  116. {bergson-2.2.3 → bergson-2.3.0}/tests/test_compute_lambda.py +0 -0
  117. {bergson-2.2.3 → bergson-2.3.0}/tests/test_config_runner.py +0 -0
  118. {bergson-2.2.3 → bergson-2.3.0}/tests/test_contrast.py +0 -0
  119. {bergson-2.2.3 → bergson-2.3.0}/tests/test_data.py +0 -0
  120. {bergson-2.2.3 → bergson-2.3.0}/tests/test_ddp.py +0 -0
  121. {bergson-2.2.3 → bergson-2.3.0}/tests/test_diagnose.py +0 -0
  122. {bergson-2.2.3 → bergson-2.3.0}/tests/test_distributed_batch_budget.py +0 -0
  123. {bergson-2.2.3 → bergson-2.3.0}/tests/test_distributed_cap.py +0 -0
  124. {bergson-2.2.3 → bergson-2.3.0}/tests/test_distributed_failure.py +0 -0
  125. {bergson-2.2.3 → bergson-2.3.0}/tests/test_distributed_magic.py +0 -0
  126. {bergson-2.2.3 → bergson-2.3.0}/tests/test_epoch_shuffle.py +0 -0
  127. {bergson-2.2.3 → bergson-2.3.0}/tests/test_faiss_ann_cpu_load.py +0 -0
  128. {bergson-2.2.3 → bergson-2.3.0}/tests/test_force_math_sdp.py +0 -0
  129. {bergson-2.2.3 → bergson-2.3.0}/tests/test_format.py +0 -0
  130. {bergson-2.2.3 → bergson-2.3.0}/tests/test_global_kfac.py +0 -0
  131. {bergson-2.2.3 → bergson-2.3.0}/tests/test_global_projection.py +0 -0
  132. {bergson-2.2.3 → bergson-2.3.0}/tests/test_grad_clipping.py +0 -0
  133. {bergson-2.2.3 → bergson-2.3.0}/tests/test_gradcheck.py +0 -0
  134. {bergson-2.2.3 → bergson-2.3.0}/tests/test_gradients.py +0 -0
  135. {bergson-2.2.3 → bergson-2.3.0}/tests/test_hessian.py +0 -0
  136. {bergson-2.2.3 → bergson-2.3.0}/tests/test_launch_devices.py +0 -0
  137. {bergson-2.2.3 → bergson-2.3.0}/tests/test_log_fn.py +0 -0
  138. {bergson-2.2.3 → bergson-2.3.0}/tests/test_logit_scale.py +0 -0
  139. {bergson-2.2.3 → bergson-2.3.0}/tests/test_magic.py +0 -0
  140. {bergson-2.2.3 → bergson-2.3.0}/tests/test_metasmoothness.py +0 -0
  141. {bergson-2.2.3 → bergson-2.3.0}/tests/test_moe.py +0 -0
  142. {bergson-2.2.3 → bergson-2.3.0}/tests/test_multi_query_validate.py +0 -0
  143. {bergson-2.2.3 → bergson-2.3.0}/tests/test_multinode.py +0 -0
  144. {bergson-2.2.3 → bergson-2.3.0}/tests/test_muon.py +0 -0
  145. {bergson-2.2.3 → bergson-2.3.0}/tests/test_normalizer.py +0 -0
  146. {bergson-2.2.3 → bergson-2.3.0}/tests/test_outer_product_gradients.py +0 -0
  147. {bergson-2.2.3 → bergson-2.3.0}/tests/test_output_influence.py +0 -0
  148. {bergson-2.2.3 → bergson-2.3.0}/tests/test_padding.py +0 -0
  149. {bergson-2.2.3 → bergson-2.3.0}/tests/test_per_query_magic.py +0 -0
  150. {bergson-2.2.3 → bergson-2.3.0}/tests/test_per_token_lds.py +0 -0
  151. {bergson-2.2.3 → bergson-2.3.0}/tests/test_pretokenized.py +0 -0
  152. {bergson-2.2.3 → bergson-2.3.0}/tests/test_process_autocorrelation.py +0 -0
  153. {bergson-2.2.3 → bergson-2.3.0}/tests/test_projection_inner_products.py +0 -0
  154. {bergson-2.2.3 → bergson-2.3.0}/tests/test_projection_matrix.py +0 -0
  155. {bergson-2.2.3 → bergson-2.3.0}/tests/test_projection_settings.py +0 -0
  156. {bergson-2.2.3 → bergson-2.3.0}/tests/test_query_batching_invariance.py +0 -0
  157. {bergson-2.2.3 → bergson-2.3.0}/tests/test_query_loss_padding.py +0 -0
  158. {bergson-2.2.3 → bergson-2.3.0}/tests/test_query_set_config.py +0 -0
  159. {bergson-2.2.3 → bergson-2.3.0}/tests/test_recall.py +0 -0
  160. {bergson-2.2.3 → bergson-2.3.0}/tests/test_reduce.py +0 -0
  161. {bergson-2.2.3 → bergson-2.3.0}/tests/test_save_mode_final.py +0 -0
  162. {bergson-2.2.3 → bergson-2.3.0}/tests/test_score.py +0 -0
  163. {bergson-2.2.3 → bergson-2.3.0}/tests/test_score_plot.py +0 -0
  164. {bergson-2.2.3 → bergson-2.3.0}/tests/test_score_writer_dist.py +0 -0
  165. {bergson-2.2.3 → bergson-2.3.0}/tests/test_shard_load.py +0 -0
  166. {bergson-2.2.3 → bergson-2.3.0}/tests/test_source_fisher_normalization.py +0 -0
  167. {bergson-2.2.3 → bergson-2.3.0}/tests/test_source_optimizer_variants.py +0 -0
  168. {bergson-2.2.3 → bergson-2.3.0}/tests/test_source_resume_polarity.py +0 -0
  169. {bergson-2.2.3 → bergson-2.3.0}/tests/test_source_trainer_integration.py +0 -0
  170. {bergson-2.2.3 → bergson-2.3.0}/tests/test_step_matrix.py +0 -0
  171. {bergson-2.2.3 → bergson-2.3.0}/tests/test_step_state.py +0 -0
  172. {bergson-2.2.3 → bergson-2.3.0}/tests/test_tokenize.py +0 -0
  173. {bergson-2.2.3 → bergson-2.3.0}/tests/test_trainer_callback.py +0 -0
  174. {bergson-2.2.3 → bergson-2.3.0}/tests/test_trak.py +0 -0
  175. {bergson-2.2.3 → bergson-2.3.0}/tests/test_truncation.py +0 -0
  176. {bergson-2.2.3 → bergson-2.3.0}/tests/test_validate_filter.py +0 -0
  177. {bergson-2.2.3 → bergson-2.3.0}/tests/test_validate_routing.py +0 -0
  178. {bergson-2.2.3 → bergson-2.3.0}/tests/test_validation_config.py +0 -0
  179. {bergson-2.2.3 → bergson-2.3.0}/tests/test_wandb_logging.py +0 -0
  180. {bergson-2.2.3 → bergson-2.3.0}/tests/test_weighted_ce.py +0 -0
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: bergson
3
- Version: 2.2.3
3
+ Version: 2.3.0
4
4
  Summary: Tracing the memory of neural nets with data attribution
5
5
  License: MIT License
6
6
  Keywords: interpretability,explainable-ai
@@ -91,16 +91,16 @@ Indicative performance of data attribution methods in the finetuning regime - se
91
91
  | Method | QLD | LDS | Per-token QLD |
92
92
  |:---|:---:|:---:|:---:|
93
93
  | MAGIC | 0.100 [0.090, 0.112] | 0.931 [0.925, 0.936] | 1.375 [1.348, 1.403] |
94
- | EK-FAC + ASTRA | 0.074 [0.063, 0.087] | 0.643 [0.624, 0.660] | 1.082 [1.047, 1.116] |
94
+ | EKFAC + ASTRA | 0.074 [0.063, 0.087] | 0.643 [0.624, 0.660] | 1.082 [1.047, 1.116] |
95
95
  | Eigenvalue-corrected Shampoo | 0.071 [0.060, 0.082] | 0.517 [0.491, 0.539] | 0.922 [0.887, 0.957] |
96
96
  | SOURCE (Adam, EK-FAC) | 0.071 [0.060, 0.084] | 0.473 [0.446, 0.498] | 0.908 [0.877, 0.942] |
97
- | EK-FAC | 0.070 [0.058, 0.082] | 0.454 [0.426, 0.479] | 0.863 [0.833, 0.894] |
97
+ | EKFAC | 0.070 [0.058, 0.082] | 0.454 [0.426, 0.479] | 0.863 [0.833, 0.894] |
98
98
  | BM25 | 0.062 [0.048, 0.076] | 0.220 [0.185, 0.252] | 0.677 [0.650, 0.704] |
99
+ | Activation similarity (activation covariance preconditioner) | 0.055 [0.043, 0.069] | 0.157 [0.120, 0.192] | 0.073 [0.056, 0.092] |
99
100
  | Semantic search ([Qwen3 8B](https://huggingface.co/Qwen/Qwen3-Embedding-8B)) | 0.049 [0.038, 0.061] | 0.132 [0.093, 0.169] | 0.008 [0.006, 0.010] |
100
101
  | TrackStar (no optimizer) | 0.045 [0.036, 0.055] | 0.276 [0.252, 0.299] | 0.492 [0.467, 0.517] |
101
102
  | TRAK (8-model ensemble) | 0.032 [0.024, 0.040] | 0.138 [0.111, 0.165] | 0.119 [0.112, 0.125] |
102
103
  | Gradient cosine similarity | 0.021 [0.016, 0.027] | 0.156 [0.131, 0.181] | 0.217 [0.206, 0.229] |
103
- | Activation similarity | 0.000 [-0.000, 0.001] | 0.110 [0.070, 0.149] | 0.028 [0.018, 0.039] |
104
104
 
105
105
  Results with 95% confidence intervals for GPT-2 finetuned on 4 epochs of the WikiText corpus. Held-out loss dropped from 3.545 to 3.111 over training.
106
106
 
@@ -30,16 +30,16 @@ Indicative performance of data attribution methods in the finetuning regime - se
30
30
  | Method | QLD | LDS | Per-token QLD |
31
31
  |:---|:---:|:---:|:---:|
32
32
  | MAGIC | 0.100 [0.090, 0.112] | 0.931 [0.925, 0.936] | 1.375 [1.348, 1.403] |
33
- | EK-FAC + ASTRA | 0.074 [0.063, 0.087] | 0.643 [0.624, 0.660] | 1.082 [1.047, 1.116] |
33
+ | EKFAC + ASTRA | 0.074 [0.063, 0.087] | 0.643 [0.624, 0.660] | 1.082 [1.047, 1.116] |
34
34
  | Eigenvalue-corrected Shampoo | 0.071 [0.060, 0.082] | 0.517 [0.491, 0.539] | 0.922 [0.887, 0.957] |
35
35
  | SOURCE (Adam, EK-FAC) | 0.071 [0.060, 0.084] | 0.473 [0.446, 0.498] | 0.908 [0.877, 0.942] |
36
- | EK-FAC | 0.070 [0.058, 0.082] | 0.454 [0.426, 0.479] | 0.863 [0.833, 0.894] |
36
+ | EKFAC | 0.070 [0.058, 0.082] | 0.454 [0.426, 0.479] | 0.863 [0.833, 0.894] |
37
37
  | BM25 | 0.062 [0.048, 0.076] | 0.220 [0.185, 0.252] | 0.677 [0.650, 0.704] |
38
+ | Activation similarity (activation covariance preconditioner) | 0.055 [0.043, 0.069] | 0.157 [0.120, 0.192] | 0.073 [0.056, 0.092] |
38
39
  | Semantic search ([Qwen3 8B](https://huggingface.co/Qwen/Qwen3-Embedding-8B)) | 0.049 [0.038, 0.061] | 0.132 [0.093, 0.169] | 0.008 [0.006, 0.010] |
39
40
  | TrackStar (no optimizer) | 0.045 [0.036, 0.055] | 0.276 [0.252, 0.299] | 0.492 [0.467, 0.517] |
40
41
  | TRAK (8-model ensemble) | 0.032 [0.024, 0.040] | 0.138 [0.111, 0.165] | 0.119 [0.112, 0.125] |
41
42
  | Gradient cosine similarity | 0.021 [0.016, 0.027] | 0.156 [0.131, 0.181] | 0.217 [0.206, 0.229] |
42
- | Activation similarity | 0.000 [-0.000, 0.001] | 0.110 [0.070, 0.149] | 0.028 [0.018, 0.039] |
43
43
 
44
44
  Results with 95% confidence intervals for GPT-2 finetuned on 4 epochs of the WikiText corpus. Held-out loss dropped from 3.545 to 3.111 over training.
45
45
 
@@ -1,4 +1,4 @@
1
- __version__ = "2.2.3"
1
+ __version__ = "2.3.0"
2
2
 
3
3
  import logging
4
4
 
@@ -84,12 +84,20 @@ def build_worker(
84
84
  model, target_modules = setup_model_and_peft(index_cfg)
85
85
  processor = create_processor(model, index_cfg, target_modules)
86
86
 
87
- maybe_auto_batch_size(index_cfg, model, ds, processor, target_modules, rank)
88
-
89
87
  attention_cfgs = {
90
88
  module: index_cfg.attention for module in index_cfg.split_attention_modules
91
89
  }
92
90
 
91
+ maybe_auto_batch_size(
92
+ index_cfg,
93
+ model,
94
+ ds,
95
+ processor,
96
+ target_modules,
97
+ attention_cfgs,
98
+ preprocess_cfg,
99
+ )
100
+
93
101
  kwargs = {
94
102
  "model": model,
95
103
  "data": ds,
@@ -52,8 +52,13 @@ class DataConfig(Serializable):
52
52
  When specified, gradients are calculated using the policy
53
53
  gradient loss from Dr. GRPO. https://arxiv.org/abs/2503.20783"""
54
54
 
55
+ advantage_column: str = ""
56
+ """Optional column in the dataset that contains per-example advantages, e.g.
57
+ those logged by a GRPO trainer. When specified, gradients are calculated using
58
+ the Dr. GRPO policy gradient loss."""
59
+
55
60
  skip_nan_rewards: bool = False
56
- """Whether to skip examples with NaN rewards."""
61
+ """Whether to skip examples with NaN rewards or advantages."""
57
62
 
58
63
  truncation: bool = False
59
64
  """Whether to truncate long documents to fit the token budget."""
@@ -73,6 +78,10 @@ class DataConfig(Serializable):
73
78
  sequences of this length. Incompatible with truncation and format_template."""
74
79
 
75
80
  def __post_init__(self):
81
+ if self.reward_column and self.advantage_column:
82
+ raise ValueError(
83
+ "reward_column and advantage_column cannot both be specified"
84
+ )
76
85
  if self.chunk_length > 0:
77
86
  if self.truncation:
78
87
  raise ValueError("chunk_length and truncation cannot both be True")
@@ -15,14 +15,15 @@ from bergson.utils.utils import assert_type
15
15
  @dataclass(kw_only=True)
16
16
  class ShampooCollector(HookCollectorBase):
17
17
  """
18
- Collects activation and gradient covariances for TKFAC.
18
+ Collects activation and gradient covariances for Shampoo.
19
19
 
20
20
  Computes:
21
- A_shampoo = sum over batches of Grad @ Grad.T for activations
22
- S_shampoo = sum over batches of Grad.T @ Grad for gradients * trace(A_cov)
21
+ A_shampoo = sum over batches of (Grad.T @ Grad) / trace for activations
22
+ S_shampoo = sum over batches of (Grad @ Grad.T) for gradients
23
23
 
24
-
25
- where X is input activations [N*S, I] and G is output gradients [N*S, O].
24
+ where Grad = G.T @ X is the batch gradient [O, I], X is input activations
25
+ [N*S, I], G is output gradients [N*S, O], and trace is the trace of the
26
+ summed activation factor.
26
27
  """
27
28
 
28
29
  dtype: torch.dtype
@@ -42,7 +43,7 @@ class ShampooCollector(HookCollectorBase):
42
43
  )
43
44
 
44
45
  def forward_hook(self, module: nn.Module, a: Tensor) -> None:
45
- """Compute activation covariance: A^T @ A."""
46
+ """Store the input activations for the backward hook."""
46
47
 
47
48
  mask = self.collection_mask(module)
48
49
  assert mask is not None, "Collection mask not set for forward hook."
@@ -60,7 +61,7 @@ class ShampooCollector(HookCollectorBase):
60
61
  module._inputs = a_bi
61
62
 
62
63
  def backward_hook(self, module: nn.Module, g: Tensor) -> None:
63
- """Compute gradient covariance: G^T @ G."""
64
+ """Accumulate gradient and activation covariances, A.T @ A and G.T @ G."""
64
65
  name = assert_type(str, module._name)
65
66
  S_shampoo_po = self.S_shampoo_dict[name]
66
67
  A_shampoo_ki = self.A_shampoo_dict[name]
@@ -0,0 +1,260 @@
1
+ import dataclasses
2
+ import gc
3
+ import hashlib
4
+ import json
5
+ from pathlib import Path
6
+ from typing import Any
7
+
8
+ import numpy as np
9
+ import torch
10
+ import torch.distributed as dist
11
+ from datasets import Dataset
12
+ from peft import PeftModel
13
+ from transformers import AutoTokenizer, PreTrainedModel
14
+
15
+ from bergson.collector.collector import fwd_bwd_factory
16
+ from bergson.collector.gradient_collectors import GradientCollector
17
+ from bergson.config.config import AttentionConfig, IndexConfig, PreprocessConfig
18
+ from bergson.data import _allocate_batches_world, pad_and_tensor
19
+ from bergson.gradients import GradientProcessor
20
+ from bergson.utils.worker_utils import max_tokens_for_model
21
+
22
+ CACHE_PATH = Path(".cache") / "batch_size_cache.jsonl"
23
+
24
+ PROBE_MEMORY_FRACTION = 0.9
25
+ """Share of device memory the probe batches may use, leaving the rest for the
26
+ fragmentation a full run builds up."""
27
+
28
+ UNKEYED_FIELDS = {
29
+ "run_path",
30
+ "overwrite",
31
+ "token_batch_size",
32
+ "auto_batch_size",
33
+ "distributed",
34
+ "debug",
35
+ "profile",
36
+ }
37
+ """IndexConfig fields that leave a run's memory unchanged."""
38
+
39
+
40
+ def maybe_auto_batch_size(
41
+ cfg: IndexConfig,
42
+ model: PreTrainedModel | PeftModel,
43
+ ds: Dataset,
44
+ processor: GradientProcessor,
45
+ target_modules: set[str] | None,
46
+ attention_cfgs: dict[str, AttentionConfig],
47
+ preprocess_cfg: PreprocessConfig,
48
+ ) -> None:
49
+ """Set ``cfg.token_batch_size`` to the largest budget whose batches fit, if
50
+ ``cfg.auto_batch_size``.
51
+
52
+ Every rank probes the same batches and the ranks agree on each result, so
53
+ sharded models and multi-node runs search together.
54
+ """
55
+ if not cfg.auto_batch_size:
56
+ return
57
+
58
+ lengths = [int(n) for n in ds["length"][:]]
59
+ key = _cache_key(cfg, preprocess_cfg, lengths)
60
+ rank = dist.get_rank() if dist.is_initialized() else 0
61
+
62
+ found = [_check_cache(CACHE_PATH, key) if rank == 0 else None]
63
+ if dist.is_initialized():
64
+ dist.broadcast_object_list(found, src=0)
65
+ if found[0] is not None:
66
+ cfg.token_batch_size = found[0]
67
+ print(f"Loaded token_batch_size from cache: {found[0]}")
68
+ return
69
+
70
+ tokenizer = AutoTokenizer.from_pretrained(cfg.tokenizer or cfg.model)
71
+ max_len = max_tokens_for_model(tokenizer, cfg.model, cfg.revision)
72
+ collector = GradientCollector(
73
+ model=model.base_model, # type: ignore
74
+ cfg=cfg,
75
+ processor=processor,
76
+ target_modules=target_modules,
77
+ data=ds,
78
+ preprocess_cfg=preprocess_cfg,
79
+ attention_cfgs=attention_cfgs,
80
+ filter_modules=cfg.filter_modules,
81
+ )
82
+ try:
83
+ cfg.token_batch_size = determine_batch_size(
84
+ cfg, model, ds, collector, lengths, max_len
85
+ )
86
+ finally:
87
+ del collector
88
+ _clear_cache()
89
+
90
+ if rank == 0:
91
+ _append_to_cache(CACHE_PATH, key, cfg.token_batch_size)
92
+
93
+
94
+ def determine_batch_size(
95
+ cfg: IndexConfig,
96
+ model: PreTrainedModel | PeftModel,
97
+ ds: Dataset,
98
+ collector: GradientCollector,
99
+ lengths: list[int],
100
+ max_len: int,
101
+ ) -> int:
102
+ """Find the largest token budget whose batches fit, doubling from the
103
+ longest document and then bisecting."""
104
+ # Documents longer than the budget can't be batched, and a budget past
105
+ # the context length is rejected when the data is tokenized
106
+ lo = max(lengths)
107
+ limit = max(lo, min(max_len, sum(lengths)))
108
+ print(f"Determining token_batch_size in [{lo}, {limit}]...")
109
+ if not _fits(cfg, model, ds, collector, lengths, lo):
110
+ raise RuntimeError(
111
+ f"token_batch_size={lo}, the longest document, does not fit in memory."
112
+ )
113
+
114
+ hi = None
115
+ while lo < limit:
116
+ candidate = min(2 * lo, limit)
117
+ if not _fits(cfg, model, ds, collector, lengths, candidate):
118
+ hi = candidate
119
+ break
120
+ lo = candidate
121
+
122
+ # lo fits and hi, when set, does not
123
+ while hi is not None and hi - lo > max(256, lo // 16):
124
+ mid = (lo + hi) // 2
125
+ if _fits(cfg, model, ds, collector, lengths, mid):
126
+ lo = mid
127
+ else:
128
+ hi = mid
129
+
130
+ print(f"Optimal token_batch_size: {lo}")
131
+ return lo
132
+
133
+
134
+ def probe_batches(
135
+ lengths: list[int], N: int, world_size: int, max_batch_size: int | None
136
+ ) -> list[list[int]]:
137
+ """The batches of budget ``N`` with the most padded tokens, the most
138
+ documents and the most attention entries, over every rank's batches."""
139
+ batches = [
140
+ b
141
+ for rank in _allocate_batches_world(
142
+ lengths, N, world_size, max_batch_size=max_batch_size
143
+ )
144
+ for b in rank
145
+ ]
146
+
147
+ def shape(b):
148
+ return len(b), max(lengths[i] for i in b)
149
+
150
+ keys = (
151
+ lambda b: shape(b)[0] * shape(b)[1],
152
+ lambda b: shape(b)[0],
153
+ lambda b: shape(b)[0] * shape(b)[1] ** 2,
154
+ )
155
+ return [max(batches, key=key) for key in keys]
156
+
157
+
158
+ def _fits(
159
+ cfg: IndexConfig,
160
+ model: PreTrainedModel | PeftModel,
161
+ ds: Dataset,
162
+ collector: GradientCollector,
163
+ lengths: list[int],
164
+ N: int,
165
+ ) -> bool:
166
+ """Whether every rank runs the probe batches of budget ``N`` in memory."""
167
+ world_size = dist.get_world_size() if dist.is_initialized() else 1
168
+ device = torch.device(model.device) # type: ignore[attr-defined]
169
+ fwd_bwd = fwd_bwd_factory(cfg)
170
+
171
+ print(f" Testing {N}...", end=" ", flush=True)
172
+ fits = True
173
+ _clear_cache()
174
+ if device.type == "cuda":
175
+ torch.cuda.set_per_process_memory_fraction(PROBE_MEMORY_FRACTION, device)
176
+ try:
177
+ for indices in probe_batches(lengths, N, world_size, cfg.max_batch_size):
178
+ batch = ds[indices]
179
+ x, y, _, collection_mask = pad_and_tensor(
180
+ batch["input_ids"],
181
+ labels=batch.get("labels"),
182
+ device=device,
183
+ sync_max_len=False,
184
+ )
185
+ with collector.with_batch(collection_mask):
186
+ losses = fwd_bwd(model, x, y, batch)
187
+ collector.process_batch(indices, losses=losses)
188
+ except torch.cuda.OutOfMemoryError:
189
+ fits = False
190
+ finally:
191
+ collector.mod_grads.clear()
192
+ model.zero_grad(set_to_none=True)
193
+ if device.type == "cuda":
194
+ torch.cuda.set_per_process_memory_fraction(1.0, device)
195
+ _clear_cache()
196
+
197
+ if dist.is_initialized():
198
+ flag = torch.tensor(int(fits), device=device)
199
+ dist.all_reduce(flag, op=dist.ReduceOp.MIN)
200
+ fits = bool(flag.item())
201
+ print("fits" if fits else "OOM")
202
+ return fits
203
+
204
+
205
+ def _clear_cache() -> None:
206
+ """Aggressively clear memory."""
207
+ gc.collect()
208
+ if torch.cuda.is_available():
209
+ torch.cuda.empty_cache()
210
+
211
+
212
+ def _cache_key(
213
+ cfg: IndexConfig, preprocess_cfg: PreprocessConfig, lengths: list[int]
214
+ ) -> dict[str, Any]:
215
+ """Everything a run's memory depends on: its configs, the document lengths,
216
+ the device and the number of ranks."""
217
+ index = {
218
+ k: v for k, v in dataclasses.asdict(cfg).items() if k not in UNKEYED_FIELDS
219
+ }
220
+ gpu_name, gpu_mem = "cpu", 0
221
+ if torch.cuda.is_available():
222
+ gpu_name = torch.cuda.get_device_name(0)
223
+ gpu_mem = torch.cuda.get_device_properties(0).total_memory
224
+ configs = json.dumps(
225
+ [index, dataclasses.asdict(preprocess_cfg)], sort_keys=True, default=str
226
+ )
227
+ return {
228
+ "configs": hashlib.sha256(configs.encode()).hexdigest(),
229
+ "lengths": hashlib.sha256(np.asarray(lengths, np.int64).tobytes()).hexdigest(),
230
+ "world_size": dist.get_world_size() if dist.is_initialized() else 1,
231
+ "gpu_name": gpu_name,
232
+ "gpu_memory": gpu_mem,
233
+ "torch": torch.__version__,
234
+ }
235
+
236
+
237
+ def _check_cache(cache_file: Path, key: dict[str, Any]) -> int | None:
238
+ """The batch size cached under ``key``, the latest if there are several."""
239
+ if not cache_file.exists():
240
+ return None
241
+
242
+ found = None
243
+ with open(cache_file) as f:
244
+ for line in f:
245
+ try:
246
+ row = json.loads(line)
247
+ except json.JSONDecodeError:
248
+ continue
249
+ if row.get("key") == key:
250
+ found = row.get("token_batch_size")
251
+ return found
252
+
253
+
254
+ def _append_to_cache(cache_file: Path, key: dict[str, Any], batch_size: int) -> None:
255
+ """Append a new row to the JSONL cache file."""
256
+ cache_file.parent.mkdir(parents=True, exist_ok=True)
257
+ with open(cache_file, "a") as f:
258
+ f.write(json.dumps({"key": key, "token_batch_size": batch_size}) + "\n")
259
+
260
+ print(f"Cached batch size {batch_size} to {cache_file}")
@@ -347,7 +347,9 @@ def filter_by_max_tokens(ds: Dataset, cfg: AttributionConfig) -> Dataset:
347
347
  return ds
348
348
 
349
349
 
350
- def max_tokens_for_model(tokenizer, model_str: str, revision: str | None) -> int:
350
+ def max_tokens_for_model(
351
+ tokenizer, model_str: str, revision: str | None, trust_remote_code: bool = False
352
+ ) -> int:
351
353
  # You might think model_max_length should always be the same as
352
354
  # max_position_embeddings, but some models (e.g. Pythia!) have a smaller
353
355
  # max_position_embeddings than model_max_length, so we need to check both.
@@ -360,7 +362,9 @@ def max_tokens_for_model(tokenizer, model_str: str, revision: str | None) -> int
360
362
  except ValueError:
361
363
  pass
362
364
 
363
- model_cfg = AutoConfig.from_pretrained(model_str, revision=revision)
365
+ model_cfg = AutoConfig.from_pretrained(
366
+ model_str, revision=revision, trust_remote_code=trust_remote_code
367
+ )
364
368
  model_max_length = getattr(tokenizer, "model_max_length", BIG_NUM)
365
369
  max_pos_emb = getattr(model_cfg, "max_position_embeddings", BIG_NUM)
366
370
  return min(model_max_length, max_pos_emb)
@@ -377,7 +381,12 @@ def setup_data_pipeline(
377
381
  data_cfg.dataset, data_cfg.split, data_cfg.subset, data_cfg.data_kwargs
378
382
  )
379
383
  tokenizer = AutoTokenizer.from_pretrained(cfg.tokenizer or cfg.model)
380
- max_model_length = max_tokens_for_model(tokenizer, cfg.model, cfg.revision)
384
+ trust_remote_code = bool(
385
+ simple_parse_kwargs_string(cfg.model_kwargs).get("trust_remote_code", False)
386
+ )
387
+ max_model_length = max_tokens_for_model(
388
+ tokenizer, cfg.model, cfg.revision, trust_remote_code
389
+ )
381
390
 
382
391
  if data_cfg.chunk_length > 0:
383
392
  # Sanity check
@@ -449,23 +458,28 @@ def setup_data_pipeline(
449
458
  f"Consider increasing --token_batch_size or using --truncation."
450
459
  )
451
460
 
452
- if data_cfg.reward_column:
461
+ value_column = data_cfg.reward_column or data_cfg.advantage_column
462
+ if value_column:
453
463
  assert isinstance(ds, Dataset), "Dataset required for advantage estimation"
454
464
 
455
- rewards = np.array(ds[data_cfg.reward_column], dtype=np.float64)
456
- nan_mask = np.isnan(rewards)
465
+ values = np.array(ds[value_column], dtype=np.float64)
466
+ nan_mask = np.isnan(values)
457
467
  if nan_mask.any():
458
468
  if data_cfg.skip_nan_rewards:
459
- print(f"Warning: Filtering out {nan_mask.sum()} rows with NaN rewards")
469
+ print(f"Warning: Filtering out {nan_mask.sum()} rows with NaN values")
460
470
  ds = ds.filter(lambda _, idx: not nan_mask[idx], with_indices=True)
461
471
  else:
462
- raise ValueError(
463
- f"Reward column '{data_cfg.reward_column}' contains NaN values"
464
- )
472
+ raise ValueError(f"Column '{value_column}' contains NaN values")
465
473
 
474
+ if data_cfg.reward_column:
475
+ advantages = estimate_advantage(ds, data_cfg)
476
+ else:
477
+ advantages = ds[data_cfg.advantage_column][:]
478
+ if "advantage" in ds.column_names:
479
+ ds = ds.remove_columns("advantage")
466
480
  ds = ds.add_column(
467
481
  "advantage",
468
- estimate_advantage(ds, data_cfg),
482
+ advantages,
469
483
  new_fingerprint="advantage", # type: ignore
470
484
  )
471
485
 
@@ -475,6 +489,8 @@ def setup_data_pipeline(
475
489
 
476
490
  # Remove extraneous columns
477
491
  keep = {"length", "input_ids", "labels"}
492
+ if value_column:
493
+ keep.add("advantage")
478
494
  remove_columns -= keep
479
495
  remove_columns &= set(ds.column_names)
480
496
  if remove_columns:
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: bergson
3
- Version: 2.2.3
3
+ Version: 2.3.0
4
4
  Summary: Tracing the memory of neural nets with data attribution
5
5
  License: MIT License
6
6
  Keywords: interpretability,explainable-ai
@@ -91,16 +91,16 @@ Indicative performance of data attribution methods in the finetuning regime - se
91
91
  | Method | QLD | LDS | Per-token QLD |
92
92
  |:---|:---:|:---:|:---:|
93
93
  | MAGIC | 0.100 [0.090, 0.112] | 0.931 [0.925, 0.936] | 1.375 [1.348, 1.403] |
94
- | EK-FAC + ASTRA | 0.074 [0.063, 0.087] | 0.643 [0.624, 0.660] | 1.082 [1.047, 1.116] |
94
+ | EKFAC + ASTRA | 0.074 [0.063, 0.087] | 0.643 [0.624, 0.660] | 1.082 [1.047, 1.116] |
95
95
  | Eigenvalue-corrected Shampoo | 0.071 [0.060, 0.082] | 0.517 [0.491, 0.539] | 0.922 [0.887, 0.957] |
96
96
  | SOURCE (Adam, EK-FAC) | 0.071 [0.060, 0.084] | 0.473 [0.446, 0.498] | 0.908 [0.877, 0.942] |
97
- | EK-FAC | 0.070 [0.058, 0.082] | 0.454 [0.426, 0.479] | 0.863 [0.833, 0.894] |
97
+ | EKFAC | 0.070 [0.058, 0.082] | 0.454 [0.426, 0.479] | 0.863 [0.833, 0.894] |
98
98
  | BM25 | 0.062 [0.048, 0.076] | 0.220 [0.185, 0.252] | 0.677 [0.650, 0.704] |
99
+ | Activation similarity (activation covariance preconditioner) | 0.055 [0.043, 0.069] | 0.157 [0.120, 0.192] | 0.073 [0.056, 0.092] |
99
100
  | Semantic search ([Qwen3 8B](https://huggingface.co/Qwen/Qwen3-Embedding-8B)) | 0.049 [0.038, 0.061] | 0.132 [0.093, 0.169] | 0.008 [0.006, 0.010] |
100
101
  | TrackStar (no optimizer) | 0.045 [0.036, 0.055] | 0.276 [0.252, 0.299] | 0.492 [0.467, 0.517] |
101
102
  | TRAK (8-model ensemble) | 0.032 [0.024, 0.040] | 0.138 [0.111, 0.165] | 0.119 [0.112, 0.125] |
102
103
  | Gradient cosine similarity | 0.021 [0.016, 0.027] | 0.156 [0.131, 0.181] | 0.217 [0.206, 0.229] |
103
- | Activation similarity | 0.000 [-0.000, 0.001] | 0.110 [0.070, 0.149] | 0.028 [0.018, 0.039] |
104
104
 
105
105
  Results with 95% confidence intervals for GPT-2 finetuned on 4 epochs of the WikiText corpus. Held-out loss dropped from 3.545 to 3.111 over training.
106
106
 
@@ -101,6 +101,7 @@ tests/test_approx_unrolling_checkpoint_parse.py
101
101
  tests/test_attention_head_normalizers.py
102
102
  tests/test_attribute_tokens.py
103
103
  tests/test_attributor.py
104
+ tests/test_auto_batch_size.py
104
105
  tests/test_bank_loss_cache.py
105
106
  tests/test_banked_model_loading.py
106
107
  tests/test_batch_size_invariance.py
@@ -37,7 +37,7 @@ dependencies = [
37
37
  "bitsandbytes",
38
38
  "huggingface-hub>=1.13.0",
39
39
  ]
40
- version = "2.2.3"
40
+ version = "2.3.0"
41
41
  [project.optional-dependencies]
42
42
  dev = [
43
43
  "pre-commit",
@@ -1,5 +1,6 @@
1
1
  import json
2
2
 
3
+ import pytest
3
4
  from datasets import Dataset
4
5
 
5
6
  from bergson.config import DataConfig, IndexConfig
@@ -83,3 +84,57 @@ def test_advantages_computed_with_drop_columns(tmp_path):
83
84
  # "foo bar" group mean = 15.0: advantages = [-5.0, 5.0]
84
85
  assert abs(advantages[2] - (-5.0)) < 1e-9
85
86
  assert abs(advantages[3] - 5.0) < 1e-9
87
+
88
+
89
+ def _pipeline_advantages(tmp_path, rows, **data_kwargs):
90
+ path = tmp_path / "rows.json"
91
+ path.write_text("\n".join(json.dumps(r) for r in rows))
92
+ cfg = IndexConfig(
93
+ run_path=str(tmp_path / "run"),
94
+ model="EleutherAI/pythia-14m",
95
+ token_batch_size=2048,
96
+ data=DataConfig(dataset=str(path), **data_kwargs),
97
+ )
98
+ ds, _ = setup_data_pipeline(cfg)
99
+ return ds["advantage"]
100
+
101
+
102
+ def test_advantage_column_used_as_given(tmp_path):
103
+ rows = [
104
+ {"text": "hello world", "adv": 0.5},
105
+ {"text": "hello world", "adv": 2.0},
106
+ {"text": "foo bar", "adv": -1.5},
107
+ ]
108
+ assert _pipeline_advantages(tmp_path, rows, advantage_column="adv") == [
109
+ 0.5,
110
+ 2.0,
111
+ -1.5,
112
+ ]
113
+
114
+
115
+ def test_existing_advantage_column(tmp_path):
116
+ """A dataset column named "advantage" can be the advantage column, and is
117
+ replaced by the estimate when rewards are given."""
118
+ rows = [
119
+ {"text": "hello world", "advantage": 0.5, "reward": 1.0},
120
+ {"text": "hello world", "advantage": 2.0, "reward": 3.0},
121
+ ]
122
+ assert _pipeline_advantages(tmp_path, rows, advantage_column="advantage") == [
123
+ 0.5,
124
+ 2.0,
125
+ ]
126
+ assert _pipeline_advantages(tmp_path, rows, reward_column="reward") == [-1.0, 1.0]
127
+
128
+
129
+ def test_nan_advantages(tmp_path):
130
+ rows = [{"text": "hello world", "adv": 1.0}, {"text": "foo bar", "adv": None}]
131
+ with pytest.raises(ValueError, match="Column 'adv' contains NaN"):
132
+ _pipeline_advantages(tmp_path, rows, advantage_column="adv")
133
+ assert _pipeline_advantages(
134
+ tmp_path, rows, advantage_column="adv", skip_nan_rewards=True
135
+ ) == [1.0]
136
+
137
+
138
+ def test_conflicting_advantage_config():
139
+ with pytest.raises(ValueError, match="cannot both be specified"):
140
+ DataConfig(reward_column="reward", advantage_column="adv")