Ark
Benchmarks

Benchmarks

This chapter gives an overview of the runtime cost of typical Ark operations. All time information is per entity. All components used in the benchmarks have two int64 fields. Batch operations are performed in batches of 1000 entities.

Benchmark code: benchmark/table in the GitHub repository.

Benchmarks are run automatically in the GitHub CI, and are updated on this page on every merge into the main branch. They always reflect the latest development state of Ark.

For comparative benchmarks of different Go ECS implementations, see the go-ecs-benchmarks repository.


Last run: Thu, 04 Dec 2025 20:32:50 UTC
Version: Ark v0.7.0-dev
Go version: 1.25.1
CPU: AMD EPYC 7763 64-Core Processor

Query

Operation Time Remark
Query.Next 0.6 ns
Query.Next + Query.Get 1 1.2 ns
Query.Next + Query.Get 2 1.4 ns
Query.Next + Query.Get 5 2.5 ns
Query.Next + Query.Entity 1.2 ns
Query.Next + Query.Relation 1.6 ns
Filter1.Query + Query1.Close 36.8 ns
Filter1.Query + Query1.Close 37.6 ns registered filter

World access

Operation Time Remark
World.Alive 0.8 ns random, 1000 entities
Map.Get 2.4 ns random, 1000 entities
Map.GetUnchecked 1.8 ns random, 1000 entities
Map.Has 2.2 ns random, 1000 entities
Map.HasUnchecked 1.6 ns random, 1000 entities
Map5.Get 5 7.9 ns random, 1000 entities
Map5.HasAll 5 5.7 ns random, 1000 entities
Map.GetRelation 2.6 ns random, 1000 entities
Map.GetRelationUnchecked 2.1 ns random, 1000 entities

Entities

Operation Time Remark
Entity.IsZero 0.3 ns
World.NewEntity 16.6 ns memory already alloc.
Map1.NewEntityFn w/ 1 Comp 32.4 ns memory already alloc.
Map5.NewEntityFn w/ 5 Comps 49.2 ns memory already alloc.
Map1.NewEntity w/ 1 Comp 40.5 ns memory already alloc.
Map5.NewEntity w/ 5 Comps 61.1 ns memory already alloc.
World.RemoveEntity 30.5 ns
World.RemoveEntity w/ 1 Comp 36.5 ns
World.RemoveEntity w/ 5 Comps 65.5 ns

Entities, batched

Operation Time Remark
World.NewEntities 9.8 ns 1000, memory already alloc.
Map1.NewBatchFn w/ 1 Comp 10.1 ns 1000, memory already alloc.
Map5.NewBatchFn w/ 5 Comps 9.8 ns 1000, memory already alloc.
World.RemoveEntities 6.1 ns 1000
World.RemoveEntities w/ 1 Comp 6.3 ns 1000
World.RemoveEntities w/ 5 Comps 7.7 ns 1000

Components

Operation Time Remark
Map1.AddFn 1 Comp 41.8 ns memory already alloc.
Map5.AddFn 5 Comps 55.7 ns memory already alloc.
Map1.AddFn 1 to 5 Comps 110.5 ns memory already alloc.
Map1.Add 1 Comp 47.3 ns memory already alloc.
Map5.Add 5 Comps 73.9 ns memory already alloc.
Map1.Add 1 to 5 Comps 116.9 ns memory already alloc.
Map1.Remove 1 Comp 44.5 ns memory already alloc.
Map5.Remove 5 Comps 90.0 ns memory already alloc.
Map1.Remove 1 of 5 Comps 104.9 ns memory already alloc.
Exchange1.ExchangeFn 1 Comp 56.0 ns memory already alloc.
Exchange1.ExchangeFn 1 of 5 Comps 113.1 ns memory already alloc.
Exchange1.Exchange 1 Comp 62.5 ns memory already alloc.
Exchange1.Exchange 1 of 5 Comps 120.7 ns memory already alloc.

Components, batched

Operation Time Remark
Map1.AddBatchFn 1 Comp 5.2 ns 1000, memory already alloc.
Map5.AddBatchFn 5 Comps 5.2 ns 1000, memory already alloc.
Map1.AddBatchFn 1 to 5 Comps 8.8 ns 1000, memory already alloc.
Map1.RemoveBatch 1 Comp 5.6 ns 1000, memory already alloc.
Map5.RemoveBatch 5 Comps 6.6 ns 1000, memory already alloc.
Map1.RemoveBatch 1 of 5 Comps 8.2 ns 1000, memory already alloc.
Exchange1.ExchangeBatchFn 1 Comp 5.6 ns 1000, memory already alloc.
Exchange1.ExchangeBatchFn 1 of 5 Comps 8.2 ns 1000, memory already alloc.

Other

Operation Time Remark
ecs.NewWorld 18.8 μs
World.Reset 80.8 ns empty world
ecs.ComponentID 19.0 ns component already registered
ToolsCheat sheet