Taxonomy Distribution Report

Overview

• Total Concepts: 200
• Number of Taxonomies: 11
• Average Concepts per Taxonomy: 18.2

Distribution Summary

Category	TaxonomyID	Count	Percentage	Status
Expression API	EXAPI	30	15.0%	✅
Expression AST & System	EXAST	24	12.0%	✅
Type System & Schema	TYPES	22	11.0%	✅
Relation API	RLAPI	20	10.0%	✅
Relation AST & System	RLAST	20	10.0%	✅
DAG & DataPackage	DAG	18	9.0%	✅
Expression Backends	EXBAK	16	8.0%	✅
Pipeline Framework	PIPE	14	7.0%	✅
Foundation Concepts	FOUND	12	6.0%	✅
Core Infrastructure	INFRA	12	6.0%	✅
Relation Backends	RLBAK	12	6.0%	✅

Visual Distribution

Expression API          ███████  30 ( 15.0%)
Expression AST & System ██████  24 ( 12.0%)
Type System & Schema    █████  22 ( 11.0%)
Relation API            █████  20 ( 10.0%)
Relation AST & System   █████  20 ( 10.0%)
DAG & DataPackage       ████  18 (  9.0%)
Expression Backends     ████  16 (  8.0%)
Pipeline Framework      ███  14 (  7.0%)
Foundation Concepts     ███  12 (  6.0%)
Core Infrastructure     ███  12 (  6.0%)
Relation Backends       ███  12 (  6.0%)

Balance Analysis

✅ No Over-Represented Categories

All categories are under the 30% threshold. Good balance!

Category Details

Expression API (EXAPI)

Count: 30 concepts (15.0%)

Concepts:

• 1. col Function
• 1. lit Function
• 1. Expression Building
• 1. BaseExpressionAPI
• 1. BooleanExpressionAPI
• 1. Fluent Expression Chain
• 1. Operator Overloading
• 1. String Namespace
• 1. Datetime Namespace
• 1. Struct Namespace
• 1. List Namespace
• 1. Name Namespace
• 1. NamespaceDescriptor
• 1. when Function
• 1. coalesce Function
• ...and 15 more

Expression AST & System (EXAST)

Count: 24 concepts (12.0%)

Concepts:

• 1. ExpressionNode Base
• 1. ScalarFunctionNode
• 1. FieldReferenceNode
• 1. LiteralNode
• 1. CastNode
• 1. IfThenNode
• 1. SingularOrListNode
• 1. WindowFunctionNode
• 1. WindowSpec
• 1. WindowBound
• 1. OverNode
• 1. Function Key Enums
• 1. FKEY Substrait Prefix
• 1. FKEY Mountainash Prefix
• 1. ExpressionFunctionDef
• ...and 9 more

Type System & Schema (TYPES)

Count: 22 concepts (11.0%)

Concepts:

• 1. TypeSpec
• 1. FieldSpec
• 1. FieldConstraints
• 1. UniversalType Enum
• 1. Type Bridge
• 1. Backend Type Mapping
• 1. Foreign Keys
• 1. ForeignKeyReference
• 1. Custom Type Registry
• 1. Type Converters
• 1. Frictionless Standard
• 1. Table Schema
• 1. Schema Extraction
• 1. DataFrame Extraction
• 1. Dataclass Extraction
• ...and 7 more

Relation API (RLAPI)

Count: 20 concepts (10.0%)

Concepts:

• 1. relation Factory
• 1. Relation Class
• 1. RelationBase
• 1. Filter Operation
• 1. Sort Operation
• 1. Head Fetch Operation
• 1. Select Project Operation
• 1. Join Operation
• 1. Group By Operation
• 1. GroupedRelation
• 1. Aggregation on Groups
• 1. Set Operations
• 1. concat Function
• 1. Conform Operation
• 1. Unnest Operation
• ...and 5 more

Relation AST & System (RLAST)

Count: 20 concepts (10.0%)

Concepts:

• 1. RelationNode Base
• 1. ReadRelNode
• 1. ProjectRelNode
• 1. FilterRelNode
• 1. AggregateRelNode
• 1. JoinRelNode
• 1. FetchRelNode
• 1. SortRelNode
• 1. SetRelNode
• 1. ExtensionRelNode
• 1. SourceRelNode
• 1. RefRelNode
• 1. ResourceReadRelNode
• 1. Relation Protocols
• 1. UnifiedRelationVisitor
• ...and 5 more

DAG & DataPackage (DAG)

Count: 18 concepts (9.0%)

Concepts:

• 1. RelationDAG
• 1. Named Relations
• 1. dag.ref Method
• 1. Dependency Edges
• 1. Constraint Edges
• 1. Two-Edge Graph Model
• 1. Topological Collection
• 1. dag.collect Method
• 1. ref_resolver Parameter
• 1. DataPackage
• 1. DataResource
• 1. TableDialect
• 1. from_descriptor Method
• 1. to_relation_dag Method
• 1. Resource Overrides
• ...and 3 more

Expression Backends (EXBAK)

Count: 16 concepts (8.0%)

Concepts:

• 1. PolarsExpressionSystem
• 1. NarwhalsExpressionSystem
• 1. IbisExpressionSystem
• 1. Polars Expr Compilation
• 1. Narwhals Expr Compilation
• 1. Ibis Expr Compilation
• 1. Backend Composition
• 1. Multiple Inheritance
• 1. Substrait Compile Files
• 1. Extension Compile Files
• 1. Known Expr Limitations
• 1. Expression Testing
• 1. Cross-Backend Parametrize
• 1. xfail Known Quirks
• 1. Arguments vs Options
• ...and 1 more

Pipeline Framework (PIPE)

Count: 14 concepts (7.0%)

Concepts:

• 1. PipelineBuilder
• 1. step Decorator
• 1. source Function
• 1. PipelineSpec
• 1. StepDefinition
• 1. StepContext
• 1. StepResult
• 1. SimplePipelineRunner
• 1. ParamSpec
• 1. Parameter Binding
• 1. relation.params Method
• 1. ParamsRelNode
• 1. PipelineStepRelNode
• 1. fold_params Function

Foundation Concepts (FOUND)

Count: 12 concepts (6.0%)

Concepts:

• 1. Python Type Hints
• 1. Protocol Classes
• 1. Pydantic Models
• 1. DataFrames
• 1. Polars Library
• 1. Pandas Library
• 1. Apache Arrow
• 1. SQL Databases
• 1. Lazy Evaluation
• 1. Method Chaining
• 1. Visitor Pattern
• 1. Directed Acyclic Graph

Core Infrastructure (INFRA)

Count: 12 concepts (6.0%)

Concepts:

• 1. Constants Module
• 1. Backend Enum
• 1. Backend System Enum
• 1. Backend Detection
• 1. DataFrame Type Guards
• 1. MountainashDtype
• 1. Lazy Import System
• 1. Factory Pattern
• 1. BaseFactoryMixin
• 1. Operation Enums
• 1. JoinType Enum
• 1. SetType Enum

Relation Backends (RLBAK)

Count: 12 concepts (6.0%)

Concepts:

• 1. PolarsRelationSystem
• 1. NarwhalsRelationSystem
• 1. IbisRelationSystem
• 1. LazyFrame Operations
• 1. Narwhals Portability
• 1. Ibis SQL Compilation
• 1. Cross-Type Joins
• 1. Join Key Coalescing
• 1. Backend Relation Testing
• 1. Backend Divergences
• 1. Execution Target
• 1. execute_on Parameter

Recommendations

• ✅ Excellent balance: Categories are evenly distributed (spread: 9.0%)
• ✅ MISC category minimal: Good categorization specificity

Educational Use Recommendations

• Use taxonomy categories for color-coding in graph visualizations
• Design curriculum modules based on taxonomy groupings
• Create filtered views for focused learning paths
• Use categories for assessment organization
• Enable navigation by topic area in interactive tools

---

Report generated by learning-graph-reports/taxonomy_distribution.py