Struct SimCell 

pub struct SimCell {
    pub id: String,
    pub region: Option<Region3D>,
    pub world: SimWorld,
    pub agents: Vec<AgentPolicy>,
    pub tick: Duration,
    pub next_deadline: DateTime<Utc>,
    pub co_placement: CoPlacement,
    pub priority: i32,
}

A gang-schedulable, checkpointable simulation unit: one world shard plus its co-resident agent policy models, advancing on a fixed tick cadence.

This is the sim-native workload type. It is also called a “habitat” in product docs; SimCell is the canonical name here.

Fields

id: String

Stable identifier for the cell (used to build member ids and the gang id).

region: Option<Region3D>

Optional spatial footprint for interest management.

world: SimWorld

The authoritative simulation world shard.

agents: Vec<AgentPolicy>

Co-resident agent policy models.

tick: Duration

Tick cadence (wall-clock budget per simulation step).

next_deadline: DateTime<Utc>

Absolute time the next tick is due — the EEVDF virtual deadline used by crate::scheduler::deadline.

co_placement: CoPlacement

How members must be placed relative to one another.

priority: i32

Base scheduling priority applied to every expanded member.

Implementations

impl SimCell

pub fn new(id: impl Into<String>, world: SimWorld, tick: Duration) -> Self

Create a new sim cell. next_deadline defaults to now + tick.

pub fn with_region(self, region: Region3D) -> Self

Attach a spatial region for interest management.

pub fn with_agent(self, agent: AgentPolicy) -> Self

Add an agent policy member.

pub fn with_co_placement(self, policy: CoPlacement) -> Self

Set the co-placement policy.

pub fn with_priority(self, priority: i32) -> Self

Set the base priority applied to every member.

pub fn with_next_deadline(self, deadline: DateTime<Utc>) -> Self

Set an explicit next-tick deadline (overrides the now + tick default).

pub fn member_count(&self) -> usize

Total number of members (world + agents).

pub fn advance_deadline(&mut self)

Advance the deadline by one tick (used after a tick completes).

pub fn expand(&self) -> Vec<SimMember>

Expand this cell into the scheduler’s SimMember list. The world is member 0; agents follow in declaration order. Each member’s workload id is deterministic (member_id) and its name embeds the cell id.

pub fn members(&self) -> Vec<Workload>

Expand into bare Workloads, as required by the task signature fn members(&self) -> Vec<Workload>. Prefer SimCell::expand when you need the role/ordinal structure.

pub fn gang_group(&self) -> GangGroup

Build the all-or-nothing GangGroup for this cell.

Trait Implementations

impl Clone for SimCell

fn clone(&self) -> SimCell

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for SimCell

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for SimCell

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for SimCell

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.