ebaml 0.2.1__tar.gz → 0.2.2__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 (163) hide show
  1. {ebaml-0.2.1 → ebaml-0.2.2}/PKG-INFO +1 -1
  2. {ebaml-0.2.1 → ebaml-0.2.2}/pyproject.toml +1 -1
  3. {ebaml-0.2.1 → ebaml-0.2.2}/pyproject.toml.orig +1 -1
  4. {ebaml-0.2.1 → ebaml-0.2.2}/src/ebaml/graphs/ebm_graph.py +7 -3
  5. ebaml-0.2.2/src/ebaml/graphs/terms.py +58 -0
  6. {ebaml-0.2.1 → ebaml-0.2.2}/src/ebaml/llm/descriptors.py +12 -7
  7. {ebaml-0.2.1 → ebaml-0.2.2}/src/ebaml/local/facts.py +10 -4
  8. {ebaml-0.2.1 → ebaml-0.2.2}/LICENSE +0 -0
  9. {ebaml-0.2.1 → ebaml-0.2.2}/README.md +0 -0
  10. {ebaml-0.2.1 → ebaml-0.2.2}/src/baml_sdk/.baml-generator-output-root +0 -0
  11. {ebaml-0.2.1 → ebaml-0.2.2}/src/baml_sdk/.baml-generator-output.json +0 -0
  12. {ebaml-0.2.1 → ebaml-0.2.2}/src/baml_sdk/.gitignore +0 -0
  13. {ebaml-0.2.1 → ebaml-0.2.2}/src/baml_sdk/__init__.py +0 -0
  14. {ebaml-0.2.1 → ebaml-0.2.2}/src/baml_sdk/__init__.pyi +0 -0
  15. {ebaml-0.2.1 → ebaml-0.2.2}/src/baml_sdk/_baml_sources.py +0 -0
  16. {ebaml-0.2.1 → ebaml-0.2.2}/src/baml_sdk/_function_registry.py +0 -0
  17. {ebaml-0.2.1 → ebaml-0.2.2}/src/baml_sdk/_inlinedbaml.py +0 -0
  18. {ebaml-0.2.1 → ebaml-0.2.2}/src/baml_sdk/_invocation_types.py +0 -0
  19. {ebaml-0.2.1 → ebaml-0.2.2}/src/baml_sdk/_invocation_types.pyi +0 -0
  20. {ebaml-0.2.1 → ebaml-0.2.2}/src/baml_sdk/_typemap.py +0 -0
  21. {ebaml-0.2.1 → ebaml-0.2.2}/src/baml_sdk/ai/__init__.py +0 -0
  22. {ebaml-0.2.1 → ebaml-0.2.2}/src/baml_sdk/ai/__init__.pyi +0 -0
  23. {ebaml-0.2.1 → ebaml-0.2.2}/src/baml_sdk/ai/clients/__init__.py +0 -0
  24. {ebaml-0.2.1 → ebaml-0.2.2}/src/baml_sdk/ai/clients/__init__.pyi +0 -0
  25. {ebaml-0.2.1 → ebaml-0.2.2}/src/baml_sdk/ai/content/__init__.py +0 -0
  26. {ebaml-0.2.1 → ebaml-0.2.2}/src/baml_sdk/ai/content/__init__.pyi +0 -0
  27. {ebaml-0.2.1 → ebaml-0.2.2}/src/baml_sdk/ai/errors/__init__.py +0 -0
  28. {ebaml-0.2.1 → ebaml-0.2.2}/src/baml_sdk/ai/errors/__init__.pyi +0 -0
  29. {ebaml-0.2.1 → ebaml-0.2.2}/src/baml_sdk/ai/events/__init__.py +0 -0
  30. {ebaml-0.2.1 → ebaml-0.2.2}/src/baml_sdk/ai/events/__init__.pyi +0 -0
  31. {ebaml-0.2.1 → ebaml-0.2.2}/src/baml_sdk/ai/internal/__init__.py +0 -0
  32. {ebaml-0.2.1 → ebaml-0.2.2}/src/baml_sdk/ai/internal/__init__.pyi +0 -0
  33. {ebaml-0.2.1 → ebaml-0.2.2}/src/baml_sdk/ai/mcp/__init__.py +0 -0
  34. {ebaml-0.2.1 → ebaml-0.2.2}/src/baml_sdk/ai/mcp/__init__.pyi +0 -0
  35. {ebaml-0.2.1 → ebaml-0.2.2}/src/baml_sdk/ai/stream/__init__.py +0 -0
  36. {ebaml-0.2.1 → ebaml-0.2.2}/src/baml_sdk/ai/stream/__init__.pyi +0 -0
  37. {ebaml-0.2.1 → ebaml-0.2.2}/src/baml_sdk/ai/tools/__init__.py +0 -0
  38. {ebaml-0.2.1 → ebaml-0.2.2}/src/baml_sdk/ai/tools/__init__.pyi +0 -0
  39. {ebaml-0.2.1 → ebaml-0.2.2}/src/baml_sdk/ai/wire/__init__.py +0 -0
  40. {ebaml-0.2.1 → ebaml-0.2.2}/src/baml_sdk/ai/wire/__init__.pyi +0 -0
  41. {ebaml-0.2.1 → ebaml-0.2.2}/src/baml_sdk/baml/__init__.py +0 -0
  42. {ebaml-0.2.1 → ebaml-0.2.2}/src/baml_sdk/baml/__init__.pyi +0 -0
  43. {ebaml-0.2.1 → ebaml-0.2.2}/src/baml_sdk/baml/crypto/__init__.py +0 -0
  44. {ebaml-0.2.1 → ebaml-0.2.2}/src/baml_sdk/baml/crypto/__init__.pyi +0 -0
  45. {ebaml-0.2.1 → ebaml-0.2.2}/src/baml_sdk/baml/csv/__init__.py +0 -0
  46. {ebaml-0.2.1 → ebaml-0.2.2}/src/baml_sdk/baml/csv/__init__.pyi +0 -0
  47. {ebaml-0.2.1 → ebaml-0.2.2}/src/baml_sdk/baml/env/__init__.py +0 -0
  48. {ebaml-0.2.1 → ebaml-0.2.2}/src/baml_sdk/baml/env/__init__.pyi +0 -0
  49. {ebaml-0.2.1 → ebaml-0.2.2}/src/baml_sdk/baml/errors/__init__.py +0 -0
  50. {ebaml-0.2.1 → ebaml-0.2.2}/src/baml_sdk/baml/errors/__init__.pyi +0 -0
  51. {ebaml-0.2.1 → ebaml-0.2.2}/src/baml_sdk/baml/fs/__init__.py +0 -0
  52. {ebaml-0.2.1 → ebaml-0.2.2}/src/baml_sdk/baml/fs/__init__.pyi +0 -0
  53. {ebaml-0.2.1 → ebaml-0.2.2}/src/baml_sdk/baml/future/__init__.py +0 -0
  54. {ebaml-0.2.1 → ebaml-0.2.2}/src/baml_sdk/baml/future/__init__.pyi +0 -0
  55. {ebaml-0.2.1 → ebaml-0.2.2}/src/baml_sdk/baml/glob/__init__.py +0 -0
  56. {ebaml-0.2.1 → ebaml-0.2.2}/src/baml_sdk/baml/glob/__init__.pyi +0 -0
  57. {ebaml-0.2.1 → ebaml-0.2.2}/src/baml_sdk/baml/hash/__init__.py +0 -0
  58. {ebaml-0.2.1 → ebaml-0.2.2}/src/baml_sdk/baml/hash/__init__.pyi +0 -0
  59. {ebaml-0.2.1 → ebaml-0.2.2}/src/baml_sdk/baml/host/__init__.py +0 -0
  60. {ebaml-0.2.1 → ebaml-0.2.2}/src/baml_sdk/baml/host/__init__.pyi +0 -0
  61. {ebaml-0.2.1 → ebaml-0.2.2}/src/baml_sdk/baml/http/__init__.py +0 -0
  62. {ebaml-0.2.1 → ebaml-0.2.2}/src/baml_sdk/baml/http/__init__.pyi +0 -0
  63. {ebaml-0.2.1 → ebaml-0.2.2}/src/baml_sdk/baml/io/__init__.py +0 -0
  64. {ebaml-0.2.1 → ebaml-0.2.2}/src/baml_sdk/baml/io/__init__.pyi +0 -0
  65. {ebaml-0.2.1 → ebaml-0.2.2}/src/baml_sdk/baml/iter/__init__.py +0 -0
  66. {ebaml-0.2.1 → ebaml-0.2.2}/src/baml_sdk/baml/iter/__init__.pyi +0 -0
  67. {ebaml-0.2.1 → ebaml-0.2.2}/src/baml_sdk/baml/json/__init__.py +0 -0
  68. {ebaml-0.2.1 → ebaml-0.2.2}/src/baml_sdk/baml/json/__init__.pyi +0 -0
  69. {ebaml-0.2.1 → ebaml-0.2.2}/src/baml_sdk/baml/media/__init__.py +0 -0
  70. {ebaml-0.2.1 → ebaml-0.2.2}/src/baml_sdk/baml/media/__init__.pyi +0 -0
  71. {ebaml-0.2.1 → ebaml-0.2.2}/src/baml_sdk/baml/net/__init__.py +0 -0
  72. {ebaml-0.2.1 → ebaml-0.2.2}/src/baml_sdk/baml/net/__init__.pyi +0 -0
  73. {ebaml-0.2.1 → ebaml-0.2.2}/src/baml_sdk/baml/ops/__init__.py +0 -0
  74. {ebaml-0.2.1 → ebaml-0.2.2}/src/baml_sdk/baml/ops/__init__.pyi +0 -0
  75. {ebaml-0.2.1 → ebaml-0.2.2}/src/baml_sdk/baml/panics/__init__.py +0 -0
  76. {ebaml-0.2.1 → ebaml-0.2.2}/src/baml_sdk/baml/panics/__init__.pyi +0 -0
  77. {ebaml-0.2.1 → ebaml-0.2.2}/src/baml_sdk/baml/random/__init__.py +0 -0
  78. {ebaml-0.2.1 → ebaml-0.2.2}/src/baml_sdk/baml/random/__init__.pyi +0 -0
  79. {ebaml-0.2.1 → ebaml-0.2.2}/src/baml_sdk/baml/regex/__init__.py +0 -0
  80. {ebaml-0.2.1 → ebaml-0.2.2}/src/baml_sdk/baml/regex/__init__.pyi +0 -0
  81. {ebaml-0.2.1 → ebaml-0.2.2}/src/baml_sdk/baml/sap/__init__.py +0 -0
  82. {ebaml-0.2.1 → ebaml-0.2.2}/src/baml_sdk/baml/sap/__init__.pyi +0 -0
  83. {ebaml-0.2.1 → ebaml-0.2.2}/src/baml_sdk/baml/spawn/__init__.py +0 -0
  84. {ebaml-0.2.1 → ebaml-0.2.2}/src/baml_sdk/baml/spawn/__init__.pyi +0 -0
  85. {ebaml-0.2.1 → ebaml-0.2.2}/src/baml_sdk/baml/sys/__init__.py +0 -0
  86. {ebaml-0.2.1 → ebaml-0.2.2}/src/baml_sdk/baml/sys/__init__.pyi +0 -0
  87. {ebaml-0.2.1 → ebaml-0.2.2}/src/baml_sdk/baml/time/__init__.py +0 -0
  88. {ebaml-0.2.1 → ebaml-0.2.2}/src/baml_sdk/baml/time/__init__.pyi +0 -0
  89. {ebaml-0.2.1 → ebaml-0.2.2}/src/baml_sdk/baml/toml/__init__.py +0 -0
  90. {ebaml-0.2.1 → ebaml-0.2.2}/src/baml_sdk/baml/toml/__init__.pyi +0 -0
  91. {ebaml-0.2.1 → ebaml-0.2.2}/src/baml_sdk/baml/ws/__init__.py +0 -0
  92. {ebaml-0.2.1 → ebaml-0.2.2}/src/baml_sdk/baml/ws/__init__.pyi +0 -0
  93. {ebaml-0.2.1 → ebaml-0.2.2}/src/baml_sdk/baml/yaml/__init__.py +0 -0
  94. {ebaml-0.2.1 → ebaml-0.2.2}/src/baml_sdk/baml/yaml/__init__.pyi +0 -0
  95. {ebaml-0.2.1 → ebaml-0.2.2}/src/baml_sdk/experimental/__init__.py +0 -0
  96. {ebaml-0.2.1 → ebaml-0.2.2}/src/baml_sdk/experimental/__init__.pyi +0 -0
  97. {ebaml-0.2.1 → ebaml-0.2.2}/src/baml_sdk/py.typed +0 -0
  98. {ebaml-0.2.1 → ebaml-0.2.2}/src/baml_sdk/reflect/__init__.py +0 -0
  99. {ebaml-0.2.1 → ebaml-0.2.2}/src/baml_sdk/reflect/__init__.pyi +0 -0
  100. {ebaml-0.2.1 → ebaml-0.2.2}/src/baml_sdk/reflect/class_/__init__.py +0 -0
  101. {ebaml-0.2.1 → ebaml-0.2.2}/src/baml_sdk/reflect/class_/__init__.pyi +0 -0
  102. {ebaml-0.2.1 → ebaml-0.2.2}/src/baml_sdk/reflect/enum/__init__.py +0 -0
  103. {ebaml-0.2.1 → ebaml-0.2.2}/src/baml_sdk/reflect/enum/__init__.pyi +0 -0
  104. {ebaml-0.2.1 → ebaml-0.2.2}/src/baml_sdk/reflect/errors/__init__.py +0 -0
  105. {ebaml-0.2.1 → ebaml-0.2.2}/src/baml_sdk/reflect/errors/__init__.pyi +0 -0
  106. {ebaml-0.2.1 → ebaml-0.2.2}/src/baml_sdk/reflect/function/__init__.py +0 -0
  107. {ebaml-0.2.1 → ebaml-0.2.2}/src/baml_sdk/reflect/function/__init__.pyi +0 -0
  108. {ebaml-0.2.1 → ebaml-0.2.2}/src/baml_sdk/reflect/interface/__init__.py +0 -0
  109. {ebaml-0.2.1 → ebaml-0.2.2}/src/baml_sdk/reflect/interface/__init__.pyi +0 -0
  110. {ebaml-0.2.1 → ebaml-0.2.2}/src/baml_sdk/vendor/__init__.py +0 -0
  111. {ebaml-0.2.1 → ebaml-0.2.2}/src/baml_sdk/vendor/__init__.pyi +0 -0
  112. {ebaml-0.2.1 → ebaml-0.2.2}/src/baml_sdk/vendor/anthropic/__init__.py +0 -0
  113. {ebaml-0.2.1 → ebaml-0.2.2}/src/baml_sdk/vendor/anthropic/__init__.pyi +0 -0
  114. {ebaml-0.2.1 → ebaml-0.2.2}/src/baml_sdk/vendor/anthropic/internal/__init__.py +0 -0
  115. {ebaml-0.2.1 → ebaml-0.2.2}/src/baml_sdk/vendor/anthropic/internal/__init__.pyi +0 -0
  116. {ebaml-0.2.1 → ebaml-0.2.2}/src/baml_sdk/vendor/assert_/__init__.py +0 -0
  117. {ebaml-0.2.1 → ebaml-0.2.2}/src/baml_sdk/vendor/assert_/__init__.pyi +0 -0
  118. {ebaml-0.2.1 → ebaml-0.2.2}/src/baml_sdk/vendor/aws/__init__.py +0 -0
  119. {ebaml-0.2.1 → ebaml-0.2.2}/src/baml_sdk/vendor/aws/__init__.pyi +0 -0
  120. {ebaml-0.2.1 → ebaml-0.2.2}/src/baml_sdk/vendor/aws/internal/__init__.py +0 -0
  121. {ebaml-0.2.1 → ebaml-0.2.2}/src/baml_sdk/vendor/aws/internal/__init__.pyi +0 -0
  122. {ebaml-0.2.1 → ebaml-0.2.2}/src/baml_sdk/vendor/claude_code/__init__.py +0 -0
  123. {ebaml-0.2.1 → ebaml-0.2.2}/src/baml_sdk/vendor/claude_code/__init__.pyi +0 -0
  124. {ebaml-0.2.1 → ebaml-0.2.2}/src/baml_sdk/vendor/claude_code/internal/__init__.py +0 -0
  125. {ebaml-0.2.1 → ebaml-0.2.2}/src/baml_sdk/vendor/claude_code/internal/__init__.pyi +0 -0
  126. {ebaml-0.2.1 → ebaml-0.2.2}/src/baml_sdk/vendor/google/__init__.py +0 -0
  127. {ebaml-0.2.1 → ebaml-0.2.2}/src/baml_sdk/vendor/google/__init__.pyi +0 -0
  128. {ebaml-0.2.1 → ebaml-0.2.2}/src/baml_sdk/vendor/google/internal/__init__.py +0 -0
  129. {ebaml-0.2.1 → ebaml-0.2.2}/src/baml_sdk/vendor/google/internal/__init__.pyi +0 -0
  130. {ebaml-0.2.1 → ebaml-0.2.2}/src/baml_sdk/vendor/openai/__init__.py +0 -0
  131. {ebaml-0.2.1 → ebaml-0.2.2}/src/baml_sdk/vendor/openai/__init__.pyi +0 -0
  132. {ebaml-0.2.1 → ebaml-0.2.2}/src/baml_sdk/vendor/openai/internal/__init__.py +0 -0
  133. {ebaml-0.2.1 → ebaml-0.2.2}/src/baml_sdk/vendor/openai/internal/__init__.pyi +0 -0
  134. {ebaml-0.2.1 → ebaml-0.2.2}/src/baml_sdk/vendor/openai/internal/decisions/__init__.py +0 -0
  135. {ebaml-0.2.1 → ebaml-0.2.2}/src/baml_sdk/vendor/openai/internal/decisions/__init__.pyi +0 -0
  136. {ebaml-0.2.1 → ebaml-0.2.2}/src/baml_sdk/vendor/testing/__init__.py +0 -0
  137. {ebaml-0.2.1 → ebaml-0.2.2}/src/baml_sdk/vendor/testing/__init__.pyi +0 -0
  138. {ebaml-0.2.1 → ebaml-0.2.2}/src/baml_sdk/vendor/trace/__init__.py +0 -0
  139. {ebaml-0.2.1 → ebaml-0.2.2}/src/baml_sdk/vendor/trace/__init__.pyi +0 -0
  140. {ebaml-0.2.1 → ebaml-0.2.2}/src/baml_sdk/vendor/typesafeai/__init__.py +0 -0
  141. {ebaml-0.2.1 → ebaml-0.2.2}/src/baml_sdk/vendor/typesafeai/__init__.pyi +0 -0
  142. {ebaml-0.2.1 → ebaml-0.2.2}/src/baml_sdk/vendor/typesafeai/internal/__init__.py +0 -0
  143. {ebaml-0.2.1 → ebaml-0.2.2}/src/baml_sdk/vendor/typesafeai/internal/__init__.pyi +0 -0
  144. {ebaml-0.2.1 → ebaml-0.2.2}/src/baml_sdk/vendor/vercel/__init__.py +0 -0
  145. {ebaml-0.2.1 → ebaml-0.2.2}/src/baml_sdk/vendor/vercel/__init__.pyi +0 -0
  146. {ebaml-0.2.1 → ebaml-0.2.2}/src/baml_sdk/vendor/vercel/internal/__init__.py +0 -0
  147. {ebaml-0.2.1 → ebaml-0.2.2}/src/baml_sdk/vendor/vercel/internal/__init__.pyi +0 -0
  148. {ebaml-0.2.1 → ebaml-0.2.2}/src/ebaml/__init__.py +0 -0
  149. {ebaml-0.2.1 → ebaml-0.2.2}/src/ebaml/benchmark.py +0 -0
  150. {ebaml-0.2.1 → ebaml-0.2.2}/src/ebaml/core/__init__.py +0 -0
  151. {ebaml-0.2.1 → ebaml-0.2.2}/src/ebaml/core/custom_types.py +0 -0
  152. {ebaml-0.2.1 → ebaml-0.2.2}/src/ebaml/core/exceptions.py +0 -0
  153. {ebaml-0.2.1 → ebaml-0.2.2}/src/ebaml/graphs/__init__.py +0 -0
  154. {ebaml-0.2.1 → ebaml-0.2.2}/src/ebaml/graphs/graph_text.py +0 -0
  155. {ebaml-0.2.1 → ebaml-0.2.2}/src/ebaml/graphs/model_kinds.py +0 -0
  156. {ebaml-0.2.1 → ebaml-0.2.2}/src/ebaml/llm/__init__.py +0 -0
  157. {ebaml-0.2.1 → ebaml-0.2.2}/src/ebaml/llm/options.py +0 -0
  158. {ebaml-0.2.1 → ebaml-0.2.2}/src/ebaml/llm/provider_errors.py +0 -0
  159. {ebaml-0.2.1 → ebaml-0.2.2}/src/ebaml/llm/retry.py +0 -0
  160. {ebaml-0.2.1 → ebaml-0.2.2}/src/ebaml/llm/sdk_setup.py +0 -0
  161. {ebaml-0.2.1 → ebaml-0.2.2}/src/ebaml/local/__init__.py +0 -0
  162. {ebaml-0.2.1 → ebaml-0.2.2}/src/ebaml/local/fact_text.py +0 -0
  163. {ebaml-0.2.1 → ebaml-0.2.2}/src/ebaml/py.typed +0 -0
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: ebaml
3
- Version: 0.2.1
3
+ Version: 0.2.2
4
4
  Summary: BAML for Explainable Boosting Machines: talk to your EBM.
5
5
  Keywords: baml,llm,explainable-ai,explainable-boosting-machine,interpretml
6
6
  Author: Johnny Godoy
@@ -1,6 +1,6 @@
1
1
  [project]
2
2
  name = "ebaml"
3
- version = "0.2.1"
3
+ version = "0.2.2"
4
4
  description = "BAML for Explainable Boosting Machines: talk to your EBM."
5
5
  readme = "README.md"
6
6
  license = "MIT"
@@ -1,6 +1,6 @@
1
1
  [project]
2
2
  name = "ebaml"
3
- version = "0.2.1"
3
+ version = "0.2.2"
4
4
  description = "BAML for Explainable Boosting Machines: talk to your EBM."
5
5
  readme = "README.md"
6
6
  license = "MIT"
@@ -27,6 +27,7 @@ from ebaml.core.exceptions import (
27
27
  )
28
28
  from ebaml.graphs.graph_text import parse_graph_text, xy_to_json
29
29
  from ebaml.graphs.model_kinds import model_kind
30
+ from ebaml.graphs.terms import main_term
30
31
 
31
32
  # nominal features are unordered categories
32
33
  _FORMAT_ALIASES = {FeatureType.NOMINAL: FeatureType.CATEGORICAL}
@@ -303,7 +304,8 @@ class EBMGraph:
303
304
  ebm: ExplainableBoostingModel
304
305
  The EBM model.
305
306
  feature_index: int
306
- The index of the feature in the EBM.
307
+ The index of the feature in the EBM. A feature that ``exclude`` or ``remove_terms`` left out has no
308
+ main-effect term, and raises ``UnsupportedModelError``.
307
309
  normalization: Normalization | str, default=Normalization.NONE
308
310
  How to normalize the graph (shift on the y-axis).
309
311
  use_feature_bounds: bool, default=True
@@ -342,8 +344,10 @@ class EBMGraph:
342
344
  # read the variables from the ebm
343
345
  feature_name = ebm.feature_names_in_[feature_index]
344
346
  feature_type = ebm.feature_types_in_[feature_index]
345
- scores = np.array(ebm.term_scores_[feature_index][1:-1], dtype=float) # Drop missing and unknown bins
346
- stds = np.asarray(ebm.standard_deviations_[feature_index][1:-1], dtype=float)
347
+ # the scores are kept by term, and term i is not always feature i
348
+ term = main_term(ebm, feature_index)
349
+ scores = np.array(ebm.term_scores_[term][1:-1], dtype=float) # Drop missing and unknown bins
350
+ stds = np.asarray(ebm.standard_deviations_[term][1:-1], dtype=float)
347
351
  selected = _select_outputs(model_kind(ebm).outputs, feature_name, scores, stds, classes)
348
352
  scores, stds = selected.scores, selected.stds
349
353
 
@@ -0,0 +1,58 @@
1
+ """The term of an EBM that holds the main effect of each feature.
2
+
3
+ interpret keeps the scores, the standard deviations, the bin weights and the importances by term, and the names, the
4
+ types and the bins by feature. Term ``i`` is not always feature ``i``: a feature that ``exclude`` leaves out at fit
5
+ time, or that ``remove_terms`` removes later, has no term, and the terms after it move. So other code finds the term
6
+ of a feature here, and does not index the term attributes with the index of a feature.
7
+ """
8
+
9
+ from ebaml.core.custom_types import ExplainableBoostingModel
10
+ from ebaml.core.exceptions import UnsupportedModelError
11
+
12
+
13
+ def main_term(ebm: ExplainableBoostingModel, feature_index: int) -> int:
14
+ """Find the term that holds the main effect of a feature.
15
+
16
+ Parameters
17
+ ----------
18
+ ebm: ExplainableBoostingModel
19
+ The fitted EBM.
20
+ feature_index: int
21
+ The index of the feature in ``feature_names_in_``.
22
+
23
+ Returns
24
+ -------
25
+ int
26
+ The index of the term in ``term_features_``, ``term_scores_`` and the other term attributes.
27
+
28
+ Raises
29
+ ------
30
+ UnsupportedModelError
31
+ If the feature has no main-effect term, because ``exclude`` or ``remove_terms`` left it out.
32
+
33
+ """
34
+ for term_index, features in enumerate(ebm.term_features_):
35
+ if tuple(features) == (feature_index,):
36
+ return term_index
37
+ msg = (
38
+ f"The feature {ebm.feature_names_in_[feature_index]!r} has no main-effect term in the EBM,"
39
+ " because exclude or remove_terms left it out."
40
+ )
41
+ raise UnsupportedModelError(msg)
42
+
43
+
44
+ def main_effect_features(ebm: ExplainableBoostingModel) -> list[int]:
45
+ """List the features that have a main-effect term.
46
+
47
+ Parameters
48
+ ----------
49
+ ebm: ExplainableBoostingModel
50
+ The fitted EBM.
51
+
52
+ Returns
53
+ -------
54
+ list[int]
55
+ The index of each such feature in ``feature_names_in_``, in increasing order.
56
+
57
+ """
58
+ return sorted(features[0] for features in ebm.term_features_ if len(features) == 1)
@@ -16,6 +16,7 @@ from baml_bridge.errors import BamlError
16
16
  from ebaml.core.custom_types import Audience, ExplainableBoostingModel, FeatureValue, coerce_enum
17
17
  from ebaml.core.exceptions import InvalidOptionError
18
18
  from ebaml.graphs.ebm_graph import EBMGraph
19
+ from ebaml.graphs.terms import main_effect_features, main_term
19
20
  from ebaml.llm.options import GraphOptions, ModelOptions, PromptOptions
20
21
  from ebaml.llm.provider_errors import provider_errors
21
22
  from ebaml.llm.retry import call_with_shrinking_graph
@@ -38,7 +39,7 @@ _DEFAULT_PROMPT_OPTIONS = PromptOptions()
38
39
 
39
40
 
40
41
  def _feature_importances_to_text(ebm: ExplainableBoostingModel) -> str:
41
- """Convert the feature importances of an EBM to text.
42
+ """Convert the importances of the main-effect terms of an EBM to text, one line per feature.
42
43
 
43
44
  Parameters
44
45
  ----------
@@ -50,10 +51,11 @@ def _feature_importances_to_text(ebm: ExplainableBoostingModel) -> str:
50
51
  str: Textual representation of the feature importances.
51
52
 
52
53
  """
54
+ # the importances are kept by term, and term i is not always feature i
53
55
  importances = ebm.term_importances()
54
56
  return "\n".join(
55
- f"{feature_name}: {importances[feature_idx]:.2f}"
56
- for feature_idx, feature_name in enumerate(ebm.feature_names_in_)
57
+ f"{ebm.feature_names_in_[feature_idx]}: {importances[main_term(ebm, feature_idx)]:.2f}"
58
+ for feature_idx in main_effect_features(ebm)
57
59
  )
58
60
 
59
61
 
@@ -374,6 +376,7 @@ def describe_ebm( # ruff: ignore[too-many-arguments] -- the model, two limits,
374
376
  Each feature graph is described like in ``describe_graph`` (concurrently, at most ``max_concurrency`` at a time,
375
377
  each retried with a simplified graph if the reply is cut off by ``max_tokens``), and then the LLM summarizes the
376
378
  descriptions. The descriptions skip the interaction terms, and an ``interactions_skipped`` warning names them.
379
+ They also skip a feature that ``exclude`` or ``remove_terms`` left out, because it has no graph.
377
380
  The logged usage leaves out the cut-off attempts, because the provider error carries no token count. It is a lower
378
381
  bound, and the ``usage`` log event has the number of those attempts in ``truncated_attempts``.
379
382
 
@@ -401,10 +404,12 @@ def describe_ebm( # ruff: ignore[too-many-arguments] -- the model, two limits,
401
404
  """
402
405
  # Convert all objects to text and check the model before prompting the LLM the first time, so that errors in
403
406
  # processing one of the graphs or in the model surface before any LLM call is paid for.
404
- feature_names = list(ebm.feature_names_in_)
405
- _warn_skipped_interactions(ebm, range(len(feature_names)))
407
+ # a feature that exclude or remove_terms left out has no graph to describe
408
+ features = main_effect_features(ebm)
409
+ feature_names = [ebm.feature_names_in_[feature_index] for feature_index in features]
410
+ _warn_skipped_interactions(ebm, features)
406
411
  feature_importances = _feature_importances_to_text(ebm)
407
- graph_texts = [_graph_text(ebm, feature_index, graph) for feature_index in range(len(feature_names))]
412
+ graph_texts = [_graph_text(ebm, feature_index, graph) for feature_index in features]
408
413
  model_spec = _model_spec(model)
409
414
  opts = _prompt_options(prompt)
410
415
 
@@ -419,7 +424,7 @@ def describe_ebm( # ruff: ignore[too-many-arguments] -- the model, two limits,
419
424
  opts=opts,
420
425
  model=model_spec,
421
426
  ),
422
- range(len(graph_texts)),
427
+ features,
423
428
  graph_texts,
424
429
  ),
425
430
  )
@@ -33,6 +33,7 @@ from ebaml.core.custom_types import ClassLabel, ExplainableBoostingModel, Featur
33
33
  from ebaml.core.exceptions import InvalidInstanceError, OptionRangeError, UnsupportedModelError
34
34
  from ebaml.graphs.ebm_graph import EBMGraph
35
35
  from ebaml.graphs.model_kinds import BinaryClassifier, model_kind
36
+ from ebaml.graphs.terms import main_effect_features, main_term
36
37
 
37
38
 
38
39
  @attrs.frozen
@@ -366,22 +367,27 @@ def _features(
366
367
  Raises
367
368
  ------
368
369
  UnsupportedModelError
369
- If the model has interactions.
370
+ If the model has interactions, or a feature has no main-effect term.
370
371
  InvalidInstanceError
371
372
  If the instance lacks a feature, a value is missing, or a category was not seen in training.
372
373
 
373
374
  """
374
- # one term of one feature per feature; comparing the lists also rejects a missing term and an interaction term
375
- if [len(term) for term in ebm.term_features_] != [1] * len(ebm.feature_names_in_):
375
+ if any(len(term) > 1 for term in ebm.term_features_):
376
376
  msg = "Local explanations need an EBM without interactions (fit with interactions=0)."
377
377
  raise UnsupportedModelError(msg)
378
+ # a feature that exclude or remove_terms left out has no score, so the prediction cannot be split by feature
379
+ with_term = main_effect_features(ebm)
380
+ if with_term != list(range(len(ebm.feature_names_in_))):
381
+ missing = [name for index, name in enumerate(ebm.feature_names_in_) if index not in with_term]
382
+ msg = f"Local explanations need a main-effect term for every feature. These features have none: {missing}."
383
+ raise UnsupportedModelError(msg)
378
384
  features = []
379
385
  for index, name in enumerate(ebm.feature_names_in_):
380
386
  if name not in instance:
381
387
  msg = f"The instance has no value for feature {name!r}."
382
388
  raise InvalidInstanceError(msg)
383
389
  graph = EBMGraph.from_ebm(ebm, index)
384
- weights = np.asarray(ebm.bin_weights_[index][1:-1], dtype=float)
390
+ weights = np.asarray(ebm.bin_weights_[main_term(ebm, index)][1:-1], dtype=float)
385
391
  bin_index = _bin_index(ebm, index, graph, instance[name])
386
392
  plausible = _plausible_bins(weights, continuous=graph.feature_type == "continuous", min_support=min_support)
387
393
  plausible[bin_index] = True
File without changes
File without changes
File without changes
File without changes
File without changes
File without changes
File without changes
File without changes
File without changes
File without changes
File without changes
File without changes
File without changes
File without changes
File without changes
File without changes
File without changes