Skip to content

Placement results

Review component placement, validity and constraints within the selected geometry/topology.

Contract version: 1.0.0. Download the full JSON schema.

Use the tables for exact field names, types and constraints. Wide tables scroll horizontally. How to read defaults, units and result states.

For interpretation and examples, read the engineering method.

Fields

Unknown fields are rejected for this object.

Field Type Required Default Constraints / meaning
available_volume_m3 number Yes Not specified exclusiveMinimum: 0.0
bus_dimensions_m ordered array: number, number, number Yes Not specified minItems: 3
maxItems: 3
candidate_ledgers array of Candidate Ledger No [] —
cg_body_m ordered array: number, number, number Yes Not specified minItems: 3
maxItems: 3
coordinate_frame string No "spacecraft_body" const: "spacecraft_body"
deployment_state string No "stowed" const: "stowed"
diagnostics Placement Diagnostics Yes Not specified —
inertia_about_cg_body_kg_m2 ordered array: ordered array: number, number, number, ordered array: number, number, number, ordered array: number, number, number Yes Not specified minItems: 3
maxItems: 3
item 0: minItems: 3
maxItems: 3
item 1: minItems: 3
maxItems: 3
item 2: minItems: 3
maxItems: 3
packaging_margin_m3 number Yes Not specified —
passed boolean Yes Not specified —
payload_kind string No "placement" const: "placement"
payload_version string No "1.0.0" const: "1.0.0"
records array of Placement Record Yes Not specified —
search_mode_used string Yes Not specified enum: ["greedy", "lookahead"]
search_stats Placement Search Stats Yes Not specified —
selected_topology_id string or null No null —
topology_candidate_ledger Candidate Ledger or null No null —
used_volume_m3 number Yes Not specified minimum: 0.0

Nested definitions

Open a definition below, or follow a type link in a field table. Direct links open the relevant section automatically.

Assessment Status

Assessment Status

enum: ["pass", "warn", "fail", "not_assessed"]

Candidate Decision

Candidate Decision

Unknown fields are rejected for this object.

Field Type Required Default Constraints / meaning
actor_id string Yes Not specified minLength: 1
maxLength: 128
pattern: "^[a-z][a-z0-9]*(?:[._:-][a-z0-9]+)*$"
candidate_id string Yes Not specified minLength: 1
maxLength: 128
pattern: "^[a-z][a-z0-9]*(?:[._:-][a-z0-9]+)*$"
decided_at_utc string Yes Not specified minLength: 20
maxLength: 40
decision_id string Yes Not specified minLength: 1
maxLength: 128
pattern: "^[a-z][a-z0-9]*(?:[._:-][a-z0-9]+)*$"
evaluation_selection Evaluation Selection Receipt or null No null —
rationale string Yes Not specified minLength: 1
maxLength: 2000
sequence integer Yes Not specified minimum: 1
status Decision Status Yes Not specified —
Candidate Delta

Candidate Delta

Unknown fields are rejected for this object.

Field Type Required Default Constraints / meaning
field_path string Yes Not specified minLength: 1
maxLength: 512
pattern: "^[a-z][a-z0-9_]*(?:\\.[a-z0-9_]+|\\[[0-9]+\\])*$"
value boolean or integer or number or string Yes Not specified —
Candidate Ledger

Candidate Ledger

Unknown fields are rejected for this object.

Field Type Required Default Constraints / meaning
candidates array of Candidate Record No [] —
contract_suite string No "sindri.contracts" const: "sindri.contracts"
contract_version string No "1.0.0" const: "1.0.0"
decisions array of Candidate Decision No [] —
evaluation_scope Evaluation Decision Scope or Study Decision Scope or null No null —
ledger_id string No "ledger.design-candidates" minLength: 1
maxLength: 128
pattern: "^[a-z][a-z0-9]*(?:[._:-][a-z0-9]+)*$"
schema_kind string No "candidate_ledger" const: "candidate_ledger"
study_id string Yes Not specified minLength: 1
maxLength: 128
pattern: "^[a-z][a-z0-9]*(?:[._:-][a-z0-9]+)*$"
transitions array of Candidate Transition No [] —
Candidate Lifecycle

Candidate Lifecycle

enum: ["defined", "generated", "evaluated", "rejected", "eligible", "ranked", "proposed", "selected", "approved"]

Candidate Record

Candidate Record

Unknown fields are rejected for this object.

Field Type Required Default Constraints / meaning
candidate_id string Yes Not specified minLength: 1
maxLength: 128
pattern: "^[a-z][a-z0-9]*(?:[._:-][a-z0-9]+)*$"
changes array of Candidate Delta No [] —
evaluation_binding Evaluation Candidate Binding or null No null —
feasibility Assessment Status No "not_assessed" —
issues array of Issue Record No [] —
lifecycle Candidate Lifecycle Yes Not specified —
objective_values array of Objective Value No [] —
parent_candidate_id string or null No null anyOf branch 1: minLength: 1
maxLength: 128
pattern: "^[a-z][a-z0-9]*(?:[._:-][a-z0-9]+)*$"
rank integer or null No null anyOf branch 1: minimum: 1
result_ids array of string No [] items: minLength: 1
maxLength: 128
pattern: "^[a-z][a-z0-9]*(?:[._:-][a-z0-9]+)*$"
Candidate Transition

Candidate Transition

Unknown fields are rejected for this object.

Field Type Required Default Constraints / meaning
actor_id string Yes Not specified minLength: 1
maxLength: 128
pattern: "^[a-z][a-z0-9]*(?:[._:-][a-z0-9]+)*$"
candidate_id string Yes Not specified minLength: 1
maxLength: 128
pattern: "^[a-z][a-z0-9]*(?:[._:-][a-z0-9]+)*$"
from_lifecycle Candidate Lifecycle Yes Not specified —
occurred_at_utc string Yes Not specified minLength: 20
maxLength: 40
rationale string Yes Not specified minLength: 1
maxLength: 2000
sequence integer Yes Not specified minimum: 1
to_lifecycle Candidate Lifecycle Yes Not specified —
transition_id string Yes Not specified minLength: 1
maxLength: 128
pattern: "^[a-z][a-z0-9]*(?:[._:-][a-z0-9]+)*$"
Decision Status

Decision Status

enum: ["proposed", "selected", "approved", "rejected"]

Evaluation Candidate Binding

Evaluation Candidate Binding

Unknown fields are rejected for this object.

Field Type Required Default Constraints / meaning
assessment_sha256 string Yes Not specified pattern: "^[0-9a-f]{64}$"
selectable boolean Yes Not specified —
source Evaluation Source Yes Not specified —
warning_check_ids array of string No [] items: minLength: 1
maxLength: 128
pattern: "^[a-z][a-z0-9]*(?:[._:-][a-z0-9]+)*$"
Evaluation Decision Scope

Evaluation Decision Scope

Unknown fields are rejected for this object.

Field Type Required Default Constraints / meaning
candidate_ids array of string Yes Not specified minItems: 1
maxItems: 100
items: minLength: 1
maxLength: 128
pattern: "^[a-z][a-z0-9]*(?:[._:-][a-z0-9]+)*$"
comparison_sha256 string Yes Not specified pattern: "^[0-9a-f]{64}$"
context_sha256 string Yes Not specified pattern: "^[0-9a-f]{64}$"
evaluation_id string Yes Not specified minLength: 1
maxLength: 128
pattern: "^[a-z][a-z0-9]*(?:[._:-][a-z0-9]+)*$"
manifest_sha256 string Yes Not specified pattern: "^[0-9a-f]{64}$"
policy_sha256 string Yes Not specified pattern: "^[0-9a-f]{64}$"
recommended_candidate_ids array of string No [] items: minLength: 1
maxLength: 128
pattern: "^[a-z][a-z0-9]*(?:[._:-][a-z0-9]+)*$"
Evaluation Selection Receipt

Evaluation Selection Receipt

Unknown fields are rejected for this object.

Field Type Required Default Constraints / meaning
accepted_warning_check_ids array of string No [] items: minLength: 1
maxLength: 128
pattern: "^[a-z][a-z0-9]*(?:[._:-][a-z0-9]+)*$"
expected_ledger_sha256 string Yes Not specified pattern: "^[0-9a-f]{64}$"
request_id string Yes Not specified minLength: 1
maxLength: 128
pattern: "^[a-z][a-z0-9]*(?:[._:-][a-z0-9]+)*$"
Evaluation Source

Evaluation Source

Unknown fields are rejected for this object.

Field Type Required Default Constraints / meaning
artifact_index_sha256 string Yes Not specified pattern: "^[0-9a-f]{64}$"
candidate_id string Yes Not specified minLength: 1
maxLength: 128
pattern: "^[a-z][a-z0-9]*(?:[._:-][a-z0-9]+)*$"
contract_version string No "1.0.0" const: "1.0.0"
input_snapshot_sha256 string Yes Not specified pattern: "^[0-9a-f]{64}$"
manifest_sha256 string Yes Not specified pattern: "^[0-9a-f]{64}$"
result_index_sha256 string Yes Not specified pattern: "^[0-9a-f]{64}$"
run_id string Yes Not specified minLength: 1
maxLength: 128
pattern: "^[a-z][a-z0-9]*(?:[._:-][a-z0-9]+)*$"
Issue Record

Issue Record

Unknown fields are rejected for this object.

Field Type Required Default Constraints / meaning
action_hint string or null No null anyOf branch 1: minLength: 1
maxLength: 1000
code string Yes Not specified minLength: 1
maxLength: 128
pattern: "^[a-z][a-z0-9]*(?:[._:-][a-z0-9]+)*$"
issue_id string Yes Not specified minLength: 1
maxLength: 128
pattern: "^[a-z][a-z0-9]*(?:[._:-][a-z0-9]+)*$"
message string Yes Not specified minLength: 1
maxLength: 2000
severity Issue Severity Yes Not specified —
source_path string or null No null anyOf branch 1: minLength: 1
maxLength: 512
statement_ids array of string No [] items: minLength: 1
maxLength: 128
pattern: "^[a-z][a-z0-9]*(?:[._:-][a-z0-9]+)*$"
Issue Severity

Issue Severity

enum: ["info", "warning", "error"]

Objective Value

Objective Value

Unknown fields are rejected for this object.

Field Type Required Default Constraints / meaning
direction string Yes Not specified enum: ["minimize", "maximize"]
metric_id string Yes Not specified minLength: 1
maxLength: 128
pattern: "^[a-z][a-z0-9]*(?:[._:-][a-z0-9]+)*$"
normalized_score number or null No null anyOf branch 1: minimum: 0.0
maximum: 1.0
value number Yes Not specified —
Placement Diagnostics

Placement Diagnostics

Unknown fields are rejected for this object.

Field Type Required Default Constraints / meaning
collision_pairs array of ordered array: string, string No [] items: minItems: 2
maxItems: 2
face_occupancy_mass_kg map of number No Not specified —
rejected_candidates array of Placement Rejected Candidate No [] —
unplaced_components array of string No [] —
violated_constraints array of string No [] —
zone_occupancy map of map of integer No Not specified —
Placement Face Score

Placement Face Score

Unknown fields are rejected for this object.

Field Type Required Default Constraints / meaning
nadir_penalty_cost number Yes Not specified —
pair_penalty number Yes Not specified —
sun_preference_cost number Yes Not specified —
total number Yes Not specified —
Placement Record

Placement Record

Unknown fields are rejected for this object.

Field Type Required Default Constraints / meaning
aabb_size_m ordered array: number, number, number or null No null anyOf branch 1: minItems: 3
maxItems: 3
adcs_wheel_cluster boolean or null No null —
architecture_node_source string or null No null —
base_mass_kg number Yes Not specified minimum: 0.0
bracket_mass_kg number Yes Not specified minimum: 0.0
candidate_id string or null No null —
center_m ordered array: number, number, number or null No null anyOf branch 1: minItems: 3
maxItems: 3
class_key string Yes Not specified minLength: 1
component string Yes Not specified minLength: 1
distribution_model string or null No null anyOf branch 1: const: "bus_uniform_box"
emit_internal_records boolean or null No null —
face string or null No null anyOf branch 1: enum: ["+X", "-X", "+Y", "-Y", "+Z", "-Z", "DISTRIBUTED"]
face_exposure_scores map of number or null No null —
fixed_panel_face_score Placement Face Score or null No null —
internal_wheel_axes_body array of ordered array: number, number, number No [] items: minItems: 3
maxItems: 3
internal_wheel_count integer or null No null anyOf branch 1: minimum: 1
internal_wheel_layout_mode string or null No null —
mass_kg number Yes Not specified minimum: 0.0
mass_rule string Yes Not specified minLength: 1
mass_source string Yes Not specified minLength: 1
mount_angle_deg integer No 0 —
mount_id string or null No null —
mount_role string or null No null —
nominal_dims_m ordered array: number, number, number or null No null anyOf branch 1: minItems: 3
maxItems: 3
orthogonality_group string or null No null —
orthogonality_policy string or null No null —
parent_component string or null No null —
placement_tags array of string No [] —
reason string or null No null —
resolved_panel_area_fraction number or null No null anyOf branch 1: minimum: 0.0
resolved_panel_area_m2 number or null No null anyOf branch 1: minimum: 0.0
resolved_panel_area_source string or null No null —
resolved_panel_aspect_ratio number or null No null anyOf branch 1: exclusiveMinimum: 0.0
resolved_panel_aspect_ratio_candidates array of number No [] —
resolved_panel_aspect_ratio_source string or null No null —
resolved_panel_candidate_count integer or null No null anyOf branch 1: minimum: 0
resolved_panel_candidate_index integer or null No null anyOf branch 1: minimum: 0
resolved_panel_size_source string or null No null —
resolved_total_solar_array_area_m2 number or null No null anyOf branch 1: minimum: 0.0
rotation_deg ordered array: number, number, number or null No null anyOf branch 1: minItems: 3
maxItems: 3
score number or null No null —
search_repair string or null No null —
shape_type string Yes Not specified minLength: 1
size_fallback_model string or null No null —
size_m ordered array: number, number, number or null No null anyOf branch 1: minItems: 3
maxItems: 3
size_rule string Yes Not specified minLength: 1
size_source string Yes Not specified minLength: 1
stage_order integer Yes Not specified minimum: 0
status string Yes Not specified enum: ["placed", "unplaced", "distributed"]
subsystem_key string Yes Not specified minLength: 1
template_source string or null No null —
zone_id string or null No null —
Placement Rejected Candidate

Placement Rejected Candidate

Unknown fields are rejected for this object.

Field Type Required Default Constraints / meaning
candidate_id string or null No null —
component string Yes Not specified minLength: 1
face string Yes Not specified enum: ["+X", "-X", "+Y", "-Y", "+Z", "-Z"]
mount_angle_deg integer or null No null —
mount_id string or null No null —
reasons array of string Yes Not specified minItems: 1
size_candidate_aspect_ratio number or null No null anyOf branch 1: exclusiveMinimum: 0.0
size_candidate_index integer Yes Not specified minimum: 0
zone_id string Yes Not specified minLength: 1
Placement Search Stats

Placement Search Stats

Unknown fields are rejected for this object.

Field Type Required Default Constraints / meaning
branch_pruned integer Yes Not specified minimum: 0
fallback_used boolean Yes Not specified —
nodes_evaluated integer Yes Not specified minimum: 0
Study Decision Scope

Study Decision Scope

Unknown fields are rejected for this object.

Field Type Required Default Constraints / meaning
candidate_ids array of string Yes Not specified minItems: 1
maxItems: 1024
items: minLength: 1
maxLength: 128
pattern: "^[a-z][a-z0-9]*(?:[._:-][a-z0-9]+)*$"
comparison_sha256 string Yes Not specified pattern: "^[0-9a-f]{64}$"
context_sha256 string Yes Not specified pattern: "^[0-9a-f]{64}$"
evaluation_id string Yes Not specified minLength: 1
maxLength: 128
pattern: "^[a-z][a-z0-9]*(?:[._:-][a-z0-9]+)*$"
manifest_sha256 string Yes Not specified pattern: "^[0-9a-f]{64}$"
policy_sha256 string Yes Not specified pattern: "^[0-9a-f]{64}$"
recommended_candidate_ids array of string No [] items: minLength: 1
maxLength: 128
pattern: "^[a-z][a-z0-9]*(?:[._:-][a-z0-9]+)*$"
scope_kind string No "study" const: "study"
shortlist_candidate_ids array of string Yes Not specified minItems: 1
maxItems: 4
items: minLength: 1
maxLength: 128
pattern: "^[a-z][a-z0-9]*(?:[._:-][a-z0-9]+)*$"

Schema integrity

Schema SHA-256: 156509ee32f5798b7be1e5d5ddb34c3be9e4936d3b8efe942e87773bfc27ea78.

Return to the reference guide.