Referensi API

API publik dikelompokkan berdasarkan distribusi. Impor dari namespace tersempit yang memiliki perilaku tersebut. Daftar di bawah mencerminkan ekspor namespace publik saat ini sehingga pembaca dapat mengaudit permukaan impor yang didukung tanpa membaca berkas __init__.py paket.

📦 Distribusi Akar

Gunakan dispatchatlas.version untuk permukaan versi paket akar yang ringan:

• __version__

🧱 Inti

dispatchatlas.core adalah batas paket bagian dalam. Paket ini mengekspor objek domain, validasi, provenans, serialisasi, seed, sistem berkas, pencatatan log, dan kontrak protokol.

Kontrak konfigurasi:

• FoundationConfig
• SeedPolicy
• SerializationFormat
• ValidationMode

Kontrak galat:

• DataQualityError
• DispatchAtlasError
• DomainValidationError
• InfeasibleScheduleError
• MissingOptionalDependencyError
• ProvenanceError
• ScheduleValidationError
• SeedDerivationError
• SerializationContractError
• UnsupportedCapabilityError
• require_finite — kembalikan nilai yang dikoersi ke float berhingga atau munculkan kontrak galat yang diberikan ketika nilainya NaN atau tak hingga.
• require_non_negative_int — kembalikan integer atau munculkan kontrak galat yang diberikan ketika nilainya negatif.
• require_positive_int — kembalikan integer atau munculkan kontrak galat yang diberikan ketika nilainya tidak positif.
• require_text — kembalikan teks yang sudah dipangkas atau munculkan kontrak galat yang diberikan ketika teksnya kosong.

Pembantu sistem berkas:

• read_text_resilient
• safe_child_directory
• safe_directory_name
• safe_namespaced_id
• write_json_artifact
• write_json_artifact_atomic
• write_text_artifact
• write_text_artifact_atomic

Keteramatan (pencatatan log terpusat):

• get_logger
• make_formatter
• console_handler
• file_handler
• scoped_logging
• configure_root_logging
• MESSAGE_FORMAT
• CONSOLE_FORMAT
• STRUCTURED_FORMAT
• DEFAULT_DATEFMT
• ROOT_LOGGER_NAME

Kontrak manifes kampanye:

• CampaignCheckpointManifest
• CampaignFailureRecord
• CampaignRunRecord
• campaign_checkpoint_from_jsonable
• campaign_checkpoint_to_jsonable
• campaign_failure_record_from_jsonable
• campaign_failure_record_to_jsonable
• campaign_run_record_from_jsonable
• campaign_run_record_to_jsonable

Kontrak model penjadwalan:

• Assignment
• Constraint
• ConstraintKind
• Dependency
• DependencyKind
• Duration
• Metadata
• Objective
• ObjectiveSense
• ObjectiveValue
• ParityBasis
• ProblemId
• ProblemSpec
• ResourceAmount
• ResourceId
• ResourceRequirement
• ResourceSpec
• Schedule
• ScheduleResult
• ScheduleStatus
• TaskId
• TaskMode
• TaskSpec
• TimePoint
• metadata_items

Protokol integrasi:

• AnalysisExporter
• BenchmarkDescriptor
• BenchmarkProvider
• DisclosureLabel
• DisclosurePolicy
• ExperimentPlan
• ExperimentResult
• ExperimentRunner
• ResultRepository
• Solver
• SolverDescriptor
• SolverRun

Kontrak provenans:

• ArtifactHash
• CitationStatus
• EnvironmentStamp
• EvidenceClass
• PackageRecord
• Provenance
• QualityGateStatus
• SeedLineage
• SourceReference
• hash_bytes
• utc_now

Kontrak seed:

• MAX_SEED
• SEED_DOMAIN_SEPARATOR
• Seed
• SeedStream
• derive_seed

Kontrak serialisasi:

• ArtifactEnvelope
• canonical_json_bytes
• dumps_envelope
• envelope_artifact
• envelope_from_jsonable
• envelope_to_jsonable
• environment_from_jsonable
• environment_to_jsonable
• loads_envelope
• problem_from_jsonable
• problem_to_jsonable
• provenance_from_jsonable
• provenance_to_jsonable
• schedule_from_jsonable
• schedule_to_jsonable

Kontrak validasi:

• ValidatedProblem
• ValidationIssue
• ValidationReport
• ValidationSeverity
• ValidationStamp
• collect_problem_issues
• collect_schedule_issues
• validate_problem
• validate_schedule

Konstanta penentuan ukuran inti:

• DEFAULT_CPU_RESERVE — CPU yang disisihkan dari kumpulan pekerja secara bawaan.
• DEFAULT_MEMORY_RESERVE_FRACTION — fraksi memori sistem yang disimpan sebagai cadangan secara bawaan.
• OBJECTIVE_FAMILY — registri yang memetakan setiap jenis objektif ke definisi kanoniknya.

Konkurensi host:

• available_cpu_count / available_system_memory_bytes — CPU yang tersedia untuk proses ini dan memori sistem yang tersedia secara terbaik-usaha.
• maximal_safe_worker_count — jumlah pekerja paralel aman maksimal untuk host.

Model kontinum (edge–fog–cloud):

• ComputeTier — sebuah lapisan komputasi kontinum (edge, fog, cloud) dengan kapasitas agregatnya.
• NetworkTopology / NetworkLink — kain komunikasi dan tautan antar-lapisan berarahnya.
• Bandwidth / DataVolume — throughput tautan positif dalam byte per detik dan data yang dapat ditransfer non-negatif dalam byte.
• PlacementAffinity — preferensi tugas terhadap target penempatan pada kontinum.

Model biaya (R||Cmax, komunikasi, eksekusi bergantung-beban, penyiapan bergantung-urutan):

• CostModel / cost_model_from_jsonable / cost_model_to_jsonable — bundel model biaya yang ditautkan ke sebuah masalah melalui pengidentifikasi, dan serialisasinya.
• ExecutionTimeMatrix / ExecutionTimeEntry / execution_matrix_from_iterable — matriks waktu eksekusi mesin-tak-terkait (p_ij).
• CompatibilityMask — himpunan kelayakan tugas-ke-mesin yang eksplisit.
• CommunicationModel / CommunicationLink — penalti komunikasi lintas-sumber-daya pada graf jarang.
• LoadModel / LoadModelKind / LoadBreakpoint — kurva eksekusi bergantung-beban dan interpolasinya di antara titik-pemecah.
• SetupMatrix / SetupEntry / SetupReferenceKind — waktu penyiapan bergantung-urutan yang dikunci berdasarkan transisi dan mesin.

Keluarga objektif:

• ObjectiveKind / ObjectiveDefinition / objective_definition — objektif penjadwalan bernama dan metadata kanoniknya.
• ObjectiveReduction / VectorObjectiveValue — aturan skalarisasi dan vektor multi-objektif terukur dengan metadata pengungkapan.
• vector_objective_from_jsonable / vector_objective_to_jsonable — serialisasi objektif-vektor.

Evaluasi objektif:

• evaluate_objective / evaluate_objectives / ObjectiveEvaluation — evaluasi satu atau setiap objektif bernama atas suatu jadwal.
• MultiObjectiveOutcome / computed_vector / multi_objective_outcome_from_jsonable — objektif skalar dan vektor beserta kelayakan untuk satu jadwal.
• EvaluationStatus / objective_sense — apakah suatu nilai dihitung atau ditangguhkan, dan sense optimisasi suatu objektif.

Kelayakan dan kendala:

• FeasibilityReport / build_feasibility_report — baris pelanggaran-keras beserta akuntansi penalti kendala-lunak.
• InfeasibleRow / SoftConstraintPenalty — satu pelanggaran-keras yang terlihat oleh peninjau dan satu penalti kendala-lunak berbobot.
• ServiceLevelConstraint / ServiceLevelOutcome / evaluate_service_level / evaluate_service_level_over_schedule / resolve_metric — kendala tingkat-layanan bernama pada suatu metrik jadwal dan evaluasinya.
• ConstraintViolationSummary / summarize_constraints — akuntansi kendala keras, lunak, dan tingkat-layanan yang teragregasi.

Pareto front dan indikator kualitas:

• dominates / to_minimization — dominansi Pareto di bawah minimisasi dan konversi sense-campuran.
• fast_non_dominated_sort / non_dominated_front / non_dominated_indices — pengurutan non-terdominasi NSGA-II dan himpunan non-terdominasi.
• FrontierPoint / LabelledPoint / frontier_data — vektor objektif berlabel dan rekaman siap-frontier.
• hypervolume / igd_plus / additive_epsilon_indicator / spread — keempat indikator kualitas: hypervolume, IGD+, epsilon aditif, dan spread tetangga-terdekat.
• QualityIndicatorReport / quality_indicator_report — keempat indikator untuk satu front terhadap himpunan referensi.

Ketegaran:

• PerturbationScenario / PerturbationSet — skenario perturbasi bernama untuk satu objektif.
• RobustnessAggregation / RobustnessValue / evaluate_robustness — bagaimana sebuah himpunan perturbasi teragregasi menjadi sebuah angka ketegaran dengan basis yang dinyatakannya.

Manifes run:

• RunTiming / ResourceUsage / SolverCounters — pewaktuan wall-clock dan anytime, penggunaan sumber daya puncak, dan penghitung upaya solver untuk satu run.
• ConvergenceSample / TimedObjectiveSample — nilai objektif yang teramati pada jumlah iterasi dan pada offset wall-clock.

Penghentian:

• TerminationPolicy — kebijakan penghentian solver multi-kriteria yang dapat dikomposisikan.

Keamanan sistem berkas:

• safe_path_under_root — sebuah path yang dikembalikan hanya ketika ia teratasi di bawah akar yang berwenang.

Serialisasi kontinum:

• bandwidth_from_jsonable / bandwidth_to_jsonable
• compute_tier_from_jsonable / compute_tier_to_jsonable
• data_volume_from_jsonable / data_volume_to_jsonable
• network_link_from_jsonable / network_link_to_jsonable
• network_topology_from_jsonable / network_topology_to_jsonable
• placement_affinity_from_jsonable / placement_affinity_to_jsonable

🧪 Tolok Ukur

dispatchatlas.bench mengekspor katalog tolok ukur, generator keluarga generik dan kontinum, metadata generator, materialisasi, validasi sitasi, karakterisasi, metrik kesulitan dan distribution-distance, seleksi, unduhan, dan kontrak taksonomi.

Kontrak katalog:

• StaticBenchmarkProvider
• benchmark_provider_for_selectors
• build_feasibility_diagnostic_catalog
• build_full_catalog
• build_smoke_catalog
• full_benchmark_provider
• full_catalog_configs
• smoke_benchmark_provider
• smoke_catalog_configs

Kontrak karakterisasi:

• CharacterizationMetrics
• CharacterizationReport
• characterize_problem

Kontrak sitasi:

• CitationClaim
• CitationMatrix
• SourceKind
• default_citation_matrix
• validate_citation_matrix

Kontrak generator:

• BenchmarkGenerator
• DagWorkflowGenerator
• GeneratorRegistry
• IndependentTaskGenerator
• cloud_edge_profile
• default_registry
• workflow_profile

Kontrak materialisasi:

• BenchmarkInstance
• BenchmarkInstanceSet
• CatalogManifest
• CatalogManifestEntry
• config_to_jsonable
• manifest_to_jsonable
• materialize_benchmark
• materialize_with_generator
• write_instance_set

Kontrak metadata:

• BenchmarkConfig
• DomainProfile
• GeneratorMetadata
• ScaleSpec

Kontrak keluarga generik:

• CostModelGenerator
• GenericFamilyGenerator
• flexible_job_shop_generator
• flow_shop_generator
• generic_family_full_configs
• generic_family_generators
• generic_family_smoke_configs
• job_shop_generator
• machine_scheduling_generator
• rcpsp_generator
• setup_flow_shop_generator

Kontrak keluarga kontinum:

• ContinuumFamilyGenerator
• ContinuumFamilySpec
• ContinuumScenario
• ContinuumStratum
• DistinctivenessRecord
• build_continuum_catalog
• build_continuum_full_catalog
• continuum_family_distinctiveness
• continuum_family_full_configs
• continuum_family_generators
• continuum_family_smoke_configs
• continuum_family_specs

Kontrak kesulitan:

• HardnessAxis
• HardnessSpec
• hardness_axis
• hardness_axis_registry
• measured_communication_compute_ratio
• measured_deadline_slack_ratio
• measured_dependency_density
• measured_duration_cv
• measured_fabric_churn
• measured_offload_deception
• measured_release_stagger

Kontrak distribution-distance:

• MAX_DISTRIBUTION_DISTANCE
• DistributionDistanceBridge
• DistributionDistanceScore
• DistributionDistanceStatus
• default_distribution_distance_bridges
• metrics_from_instance_set
• per_feature_wasserstein
• distribution_distance_score
• validate_distribution_distance_bridge

Kontrak seleksi:

• DifficultyStratum
• SubsetCriteria
• difficulty_score
• difficulty_stratum
• instance_family
• instance_profile_class
• select_benchmark_subset
• stratify_instances

Kontrak metadata-katalog dan unduhan:

• CATALOG_SCALAR_COLUMNS
• CatalogInstanceMetadata
• DownloadFormat
• catalog_instance_metadata
• catalog_instance_to_jsonable
• catalog_instance_to_row
• catalog_metadata_for_instances
• catalog_metadata_for_sets
• catalog_subset_from_bundle
• catalog_subset_from_csv
• catalog_subset_from_json
• catalog_subset_to_bundle
• catalog_subset_to_csv
• catalog_subset_to_json
• select_catalog_metadata
• serialize_catalog_subset

Kontrak taksonomi:

• DEFAULT_TAXONOMY
• BenchmarkTaxonomy
• BenchmarkTier
• ConstraintFeature
• DynamismFeature
• EnvironmentDomain
• InfrastructureRealism
• ObjectiveFeature
• ProfileClass
• SchedulingFamily
• SchedulingStructure
• UncertaintyFeature

Kontrak registri suite-referensi:

• InstanceCountStatus
• ReferenceSuite
• SuiteFormat
• default_reference_suites
• reference_suite
• validate_reference_suites

Kontrak solusi-terbaik-diketahui:

• BestKnownIngest
• BestKnownKind
• BestKnownRegistry
• BestKnownValue
• load_best_known
• load_best_known_registry

Kontrak ingesti instans-kanonik:

• SUPPORTED_FORMATS
• ParseContext
• ParsedInstance
• ReferenceSuiteGenerator
• load_reference_suite
• parse_fjs
• parse_standard_jsp
• parse_taillard_pfsp
• parse_wfformat_json
• reference_suite_config
• reference_suite_distribution_distance_bridge

🧮 Solver

dispatchatlas.solve mengekspor metadata solver, registri, baseline konstruktif, metaheuristik, varian NDSO, operator, adapter opsional, dan pembantu pemrofilan.

Kontrak baseline dan eksekusi:

• DispatchRule
• DispatchingSolver
• OrderRunRequest
• TerminationTracker — evaluator berstatus, yang-pertama-memicu, yang melipat kemajuan suatu loop pencarian ke dalam sebuah TerminationPolicy dan melaporkan kriteria mana yang menghentikan run.
• baseline_solvers
• neh_order — urutan konstruksi-penyisipan NEH (Nawaz–Enscore–Ham).

Kontrak metadata solver:

• DependencyRequirement
• SolverCapability
• SolverDescriptorSpec
• SolverFamily
• SolverMetadata
• Stochasticity

Kontrak metaheuristik:

• MetaheuristicKind
• PermutationMetaheuristicSolver
• PermutationSearchConfig
• metaheuristic_solvers

Kontrak penjadwalan-daftar berbasis-peringkat:

• ListSchedulingRank
• ListSchedulingSolver
• list_scheduling_solvers
• heft_profile — penjadwalan-daftar peringkat-naik (HEFT).
• cpop_profile — penjadwalan-daftar peringkat-naik+turun gabungan (CPOP).
• peft_profile — penjadwalan-daftar tabel-biaya-optimistik (PEFT).

Kontrak aturan-pemetaan himpunan-siap:

• MappingRule
• MappingRuleSolver
• mapping_rule_profile
• mapping_rule_solvers — aturan batch min-min, max-min, dan sufferage.

Kontrak kompetitor multi-objektif Pareto:

• NSGA2Config
• NSGA2Solver
• MOEADConfig
• MOEADSolver
• nsga2_profile
• moead_profile
• multi_objective_solvers
• crowding_distances — estimator densitas jarak-berkerumun NSGA-II.
• nsga2_environmental_selection — sintasan elitis peringkat-lalu-kerumunan.
• tchebycheff — fungsi penskalaran Tchebycheff MOEA/D.

Kontrak serakah-teriterasi:

• ITERATED_GREEDY_RS_CITATION
• IteratedGreedyRSConfig
• IteratedGreedyRSSolver — konfigurasi destruksi–konstruksi kanonik untuk flow shop permutasi.
• iterated_greedy_rs_profile
• iterated_greedy_rs_solvers

Kontrak tabu jalur-kritis:

• CriticalPathTabuConfig
• CriticalPathTabuSolver
• critical_path_tabu_profile
• critical_path_tabu_solvers
• critical_pairs — generator ketetanggaan pasangan-berdampingan jalur-kritis.

Kontrak penjadwalan-proyek (SGS serial):

• SerialSGSJustificationSolver — pembangkitan jadwal serial dengan justifikasi ganda untuk penjadwalan proyek berkendala-sumber-daya.
• serial_sgs_justification_profile
• serial_sgs_justification_solvers
• double_justified_order — lintasan justifikasi mundur–maju.
• latest_finish_order — urutan prioritas waktu-selesai-terakhir.

Kontrak NDSO:

• NDSOAblation
• NDSOMechanisms
• NDSOSolver
• NDSOVariant
• ndso_ablation_catalog
• ndso_solvers

Kontrak operator penjadwalan:

• BatchScoreResult
• ScheduleMetrics
• adjacent_swap_neighbor
• batch_score_orders
• construct_schedule
• earliest_finish_task_order
• local_search_order
• normalize_task_order
• objective_values_for
• random_topological_task_order
• repair_schedule
• schedule_metrics
• score_order
• score_schedule
• topological_task_order

Kontrak adapter opsional:

• OptionalExactSolver
• optional_solvers
• ortools_dependency

Kontrak kinerja:

• BatchScoringProfile
• ProfiledResult
• profile_call

Kontrak registri:

• ProfiledSolver
• SolverRegistry
• default_solver_registry

Konstanta penalaan solver:

• NATIVE_EXACT_TASK_CAP — batas atas jumlah-tugas yang di atasnya solver eksak native gagal-tertutup.
• RUN_COUNT_FLOOR — jumlah run berulang minimum yang dibutuhkan perbandingan yang adil.
• VELOCITY_WINDOW — jendela kecepatan-perbaikan yang diawasi pengendali anytime.
• IMPROVEMENT_FLOOR — perbaikan relatif minimum yang dihitung sebagai kemajuan.
• FEATURE_ORIGIN — metrik platform-tolok-ukur yang menjadi asal setiap fitur seleksi.

Keluarga dispatching baseline:

• DispatchingFamilySpec — sebuah keluarga dispatching bernama yang terikat pada aturan prioritas deterministik.
• RetiredFamily / RetirementReason / retired_dispatching_families — keluarga bernama yang sengaja disisihkan, masing-masing dengan rasionalnya.

Pesaing terdiversifikasi (medan metaheuristik bernama):

• CompetitorKind / CompetitorSolver / CompetitorConfig — pesaing bernama dengan parameter pencarian terbatas yang dibagikan.
• competitor_solvers / diversified_competitors — himpunan pesaing terdiversifikasi yang sadar-pengungkapan.
• post_2020_currency_anchor — referensi jangkar-kekinian pasca-2020 untuk medan tersebut.
• recent_peer_strength_bar — sejawat terbaru yang dipertahankan di bawah bar kekuatan-tempat-publikasi.

Pengoptimal kontinu (didekode ke urutan diskret):

• clpso_optimize / CLPSOConfig — optimisasi swarm partikel pembelajaran-komprehensif.
• lshade_optimize / LSHADEConfig — evolusi diferensial adaptif riwayat-keberhasilan dengan reduksi populasi linear.
• EncodedSolverKind / EncodedAdapterSolver / encoded_adapter_solvers — keluarga kontinu yang terikat pada adapter pengkodean diskret.
• ContinuousResult / SearchBudget — hasil sebuah run kontinu dan anggaran iterasi, keacakan, serta wall-clock-nya.

Pengkodean kontinu-ke-diskret:

• EncodingAdapter / encoding_adapter / encoding_adapter_catalog — pengkodean kontinu-ke-diskret bernama dengan perbaikan eksplisit.
• DecodeRule / DecodeOutcome — aturan yang mengubah vektor kunci tertransformasi menjadi urutan tugas, dan hasil terperbaikinya.
• RepairPolicy — kebijakan yang memulihkan kelayakan presedensi setelah pendekodean.
• TransferFunction — fungsi penghimpit yang memetakan komponen kontinu ke sinyal seleksi.

Solver eksak:

• ExactMethod / ExactSolver — metode eksak bernama dan sebuah adapter yang gagal-tertutup pada backend yang hilang atau masukan yang berukuran terlampau besar.
• ExactAdapterSpec / exact_adapter_specs / exact_solvers — kontrak adapter solver-eksak yang dibundel.

Pesaing banyak-objektif (NSGA-III):

• NSGA3Solver / NSGA3Config / nsga3_solvers / nsga3_profile — pesaing NSGA-III atas urutan aman-presedensi.
• nsga3_reference_points — titik referensi terstruktur Das & Dennis pada simpleks satuan.
• nsga3_environmental_selection — seleksi niching titik-referensi NSGA-III.

Varian penjadwalan ilmiah:

• SchedulingVariantKind / PermutationSchedulingVariantSolver / SchedulingVariantConfig — varian hibrida ilmiah bernama atas pengkodean urutan diskret.
• scheduling_variant_solvers — baseline varian-penjadwalan kelas-pertama.

Seleksi algoritma:

• RuleBasedSelector — sebuah baseline tolok-ukur-saja yang memeringkat kandidat dari metadata semata.
• SupervisedSelector — sebuah selektor terpelajar tetangga-terdekat berbobot-jarak yang deterministik.
• SelectionFeature / SelectionFeatures / feature_origin — fitur karakterisasi bernama yang dikonsumsi selektor dan asalnya.
• SelectionLabel / SolverRecommendation / RecommendationSource — contoh pelatihan berlabel dan rekomendasi terperingkat dengan keyakinan dan keterbatasan.

Validasi-silang selektor (generalisasi bebas-kebocoran):

• cross_validate / GeneralizationReport — generalisasi tertahan tinggalkan-satu-keluarga atas suatu korpus.
• leave_one_family_out / partition_by_families / TrainTestSplit — pemisahan latih/uji terpisah-keluarga.
• held_out_generalization — latih pada paruh latih dari pemisahan dan laporkan akurasi top-1 pada paruh ujinya.
• leakage_report / LeakageReport — tumpang-tindih instans, keluarga, dan rekaman-karakterisasi yang harus dijaga kosong oleh pemisahan bebas-kebocoran.
• validated_supervised_selector — sebuah selektor yang keyakinannya mencerminkan generalisasi tertahannya.

Antarmuka pembelajaran dan hibrida (opsional, gagal-tertutup):

• LearningInterfaceKind / LearningInterface / learning_interface / learning_interface_catalog — antarmuka pembelajaran dan hibrida bernama dengan status, kebijakan, dan fallback.
• InterfaceStatus / LearningEvidencePolicy — status siklus-hidup dan kontrak bukti yang dideklarasikan setiap permukaan semacam itu.
• ConfidenceLabel / confidence_rank — keyakinan yang mungkin dibawa sebuah rekomendasi dan kekuatan ordinalnya.
• learning_backend_available / learning_dependency / require_learning_backend — backend pembelajaran opsional (sebuah ekstra, tidak pernah bawaan) dan galat dependensi-hilang bertipenya.

Metadata solver dan sitasi:

• Citation / CitationStatus — referensi seminal kanonik (atau rasional tidak-berlaku yang eksplisit) dan apakah suatu keluarga membawanya.
• SolverEncoding — pengkodean solusi yang dicari atau dibangun sebuah solver.
• SUMMIT_EVIDENCE_LABEL — label konteks pengungkapan untuk metadata, bukti, dan ekspor.

Permukaan keluarga NDSO:

• NDSOFamilySolver — permukaan umum setiap solver keluarga-NDSO, swarm tunggal atau council.
• fast_mechanisms — himpunan mekanisme tetap dari komposisi cepat.

Mekanisme NDSO (konstruksi validitas-berdasarkan-rancangan):

• PrecedenceIndex / precedence_index — himpunan pendahulu dan pengurutan tugas stabil yang digunakan setiap konstruktor.
• GuidanceSource / GuidanceContext / select_guidance — ketiga sumber Triple-Guidance dan masukan konstruksi bersama suatu kandidat.
• guided_construction — bangun sebuah kandidat layak dari urutan panduan.
• confidence_weighted_elite — tempa Elite melalui Confidence-Weighted Voting.
• ConfidenceMatrix / consolidate_confidence / latent_archive — kepercayaan per-sel terpelajar, konsolidasi lintas-swarmnya, dan sel-sel yakin yang telah ditinggalkan Elite.
• quality_guidance / quantity_update / BetaSchedule — aturan kualitas dan kuantitas dan koefisien adaptif terpadu.
• rank_reward — sebuah imbalan turunan-peringkat dalam [0, 1].

Council Inter-Group NDSO:

• NDSOSummitSolver / summit_solver / summit_profile / SummitConfig — council Inter-Group, komposisi kualitas keluarga.
• CouncilTopology — topologi pertukaran inter-swarm yang menghubungkan swarm council.
• SummitDiagnostics — ringkasan koordinasi-council tak-berubah yang dilampirkan pada sebuah run.

Ablasi mekanisme NDSO:

• AblationEntry / ablation_map — satu ablasi pengisolasi per mekanisme kanonik.
• build_ablation_solver / run_ablation_suite / AblationRunResult — membangun dan menjalankan setiap ablasi pengisolasi terbatas-kelayakan.
• ABLATION_STATISTICAL_PLAN / StatisticalTestPlan — uji statistik lapisan-analisis bernama yang digunakan perbandingan ablasi.

Kendali anytime NDSO:

• AnytimeController / AnytimeReport — pengendali penghentian-dini kecepatan-perbaikan dan rekaman aktivitasnya.

Diagnostik NDSO:

• DiagnosticsCollector / DiagnosticsSnapshot — perekam konvergensi opsional, tanpa-overhead-saat-nonaktif, dan ringkasannya.
• IterationTrace — rekaman konvergensi satu iterasi.
• population_diversity — ketidaksetujuan-posisi berpasangan rata-rata dalam [0, 1].

Pengungkapan NDSO (pengaturan-gerbang mekanisme gagal-tertutup):

• MechanismDescriptor / mechanism_descriptor / mechanism_catalog — mekanisme bernama dan lantai pengungkapan yang dimiliki masing-masing.
• DisclosureFilter / DisclosureViolationError — gerbang gagal-tertutup atas mekanisme mana yang boleh diekspos suatu cakupan laporan.
• ReportScope / EvidenceProgram — cakupan pelaporan bertahap dan keempat program bukti bertahap yang dipetakan ke suatu lantai pengungkapan.
• base_disclosure_filter / program_disclosure_filter — filter gagal-tertutup cakupan-dasar dan per-program.
• blocks_summit_evidence — apakah filter suatu program memblokir lantai kualitas council-saja.

🚀 Kampanye

dispatchatlas.lab mengekspor konfigurasi kampanye yang dapat-direproduksi, anggaran, lingkungan, repositori, kegagalan, dan kontrak eksekusi.

Kontrak anggaran:

• CampaignBudgetReport
• dry_run_campaign

Kontrak konfigurasi:

• FULL_CAMPAIGN_BLOCKER
• BudgetScaling
• CampaignConfig
• CampaignPlan
• CampaignRunSpec
• CampaignStage
• ExecutionMode
• FailureCategory
• OutputPolicy
• ResourceBudget
• RetryPolicy
• campaign_config_hash
• config_to_jsonable
• plan_to_jsonable

Kontrak lingkungan:

• capture_campaign_environment

Kontrak galat:

• BudgetEstimationError
• CampaignConfigError
• CampaignExecutionError
• CheckpointRecoveryError
• EnvironmentCaptureError

Kontrak repositori:

• CampaignResultIndex
• CheckpointManifest
• FailureRecord
• FileResultRepository
• RunRecord

Kontrak runner:

• CampaignRunner
• classify_failure
• default_campaign_runner
• resume_campaign
• run_campaign
• validate_campaign

Konfigurasi kampanye:

• CampaignKind — kelas rancangan-eksperimen yang diwujudkan sebuah kampanye.
• StoppingProtocol / StoppingProtocolKind — protokol penghentian bernama yang dapat-dilaporkan-secara-independen untuk laporan solver-stokastik.
• RunCountPolicy / STATISTICAL_POWER_FLOOR — kebijakan jumlah-run dan jumlah replikat minimum yang di bawahnya run suatu solver ditandai kurang-daya.
• TuningBudget — anggaran penalaan per-algoritma yang setara yang menjaga perbandingan tetap adil.
• campaign_config_from_jsonable — rehidrasi konfigurasi kampanye tervalidasi dari data kompatibel-JSON.

Resolusi jumlah-run:

• ReplicateResolution / resolve_replicates — jumlah replikat teratasi untuk suatu solver, dengan tanda kurang-daya apa pun, di bawah kebijakan jumlah-run.

Invarian perbandingan-adil:

• assert_fair_comparison — validasi prakondisi struktural dari invarian perbandingan-adil.
• fair_comparison_manifest — baris manifes yang merekam jaminan perbandingan-adil.

Pengaturan mesin (resolusi terstempel-provenans empat-lapis):

• EngineSettings / resolve_engine_settings — tombol mesin teratasi di seluruh empat lapis konfigurasi, setiap field distempel dengan provenans.
• ResolvedSetting / SettingSource — nilai satu pengaturan dipasangkan dengan lapis yang memasoknya.
• apply_environment_overrides — lapiskan lapis lingkungan ke atas konfigurasi kampanye berkas atau situs-panggilan.

Topologi pekerja dan agregasi:

• WorkerTopology / topology_for_plan / probe_capacity — topologi pekerja yang menghormati-anggaran yang dipilih untuk suatu kampanye setelah menyelidiki kapasitas host.
• AggregateManifest / merge_only_aggregation — agregasi gabung-saja deterministik dari rekaman run yang selesai menjadi satu hash kampanye bit-stabil.

Atlas eksperimen:

• ExperimentAtlas / default_experiment_atlas — sebuah atlas sadar-pengungkapan dari jalur bukti yang dimiliki.
• EvidenceTrack — satu irisan bukti yang dimiliki dalam atlas eksperimen.

Matriks aplikabilitas keluarga-tolok-ukur menurut solver:

• ApplicabilityMatrix / default_applicability_matrix — matriks aplikabilitas penuh keluarga-tolok-ukur menurut solver, diturunkan dari registri langsung lalu dianotasi oleh tabel penimpaan.
• ApplicabilityCell — satu pernyataan aplikabilitas (keluarga tolok ukur, solver) yang membawa status, rasional, dan penunjuk bukti opsionalnya.
• ApplicabilityStatus — enum status terverifikasi / aproksimatif / tak-berlaku per-sel.
• ApplicabilityEvidence / ApplicabilityEvidenceKind — penunjuk bukti aman-portal (kampanye, kutipan, atau uji) dan kelas provenansnya.
• ApplicabilityOverride / default_applicability_overrides — satu peningkatan manual yang dapat-ditinjau atas sel turunan, dan tabel penimpaan dalam-kode tempat sel terverifikasi berada.
• SchedulingFamilyCell — satu rekapitulasi keluarga-penjadwalan menurut solver yang mengagregasi sel keluarga-tolok-ukur penyusunnya.
• derive_applicability_cell — menurunkan satu sel aproksimatif-atau-tak-berlaku dari metadata terdeklarasi.
• constraint_capability_bridge — jembatan fitur-kendala bertipe ke tag-kapabilitas (sumber kebenaran tunggal).
• ApplicabilityScreen / screen_campaign_applicability — menyaring hasil-silang kampanye terencana terhadap matriks, melaporkan pasangan terblokir, aproksimatif, dan terverifikasi.

📊 Analisis

dispatchatlas.analytica mengekspor penyaringan pengungkapan, ingesti, ringkasan statistik, penulis tabel Markdown deterministik, enam belas keluarga bagan yang masing-masing dirender dalam format ganda (SVG yang dapat-ditemakan dan PGFPlots .tex yang dapat-disunting), bundel bukti, dan dataset portal.

Kontrak pengungkapan:

• DisclosureExclusion
• DisclosureFilterResult
• DisclosurePolicy
• EvidenceTier
• default_disclosure_policy
• ensure_dataset_allowed
• filter_dataset

Kontrak ekspor:

• ExportBundle
• evidence_bundle_directory
• write_evidence_bundle
• write_portal_dataset

Kontrak ingesti:

• PlanRunFacts
• load_campaign_dataset
• load_result_dataset

Kontrak model:

• AnalysisConfig
• AnalysisDataset
• AnalysisSummary
• CampaignManifest
• CorrectionMethod
• ExportSurface
• FailureObservation
• ObjectiveObservation
• PairwiseComparison
• RankEntry
• RunObservation
• SolverSummary

Kontrak statistik:

• bootstrap_mean_interval
• cliffs_delta
• cohens_d
• paired_cohens_dz
• paired_observation_counts
• summarize_dataset
• two_sided_sign_test

Kontrak tabel:

• ablation_table_markdown
• arpd_markdown
• benchmark_table_markdown
• constraints_table_markdown
• ensure_effect_sizes_beside_p_values
• infeasible_rows_markdown
• multiobjective_indicators_markdown
• optimality_gap_table_markdown
• pairwise_comparison_markdown
• portal_csv
• ranking_markdown
• sensitivity_table_markdown
• solver_summary_markdown

Kontrak visualisasi (setiap keluarga bagan dirender sebagai SVG yang dapat-ditemakan dan PGFPlots .tex yang dapat-disunting):

• ablation_svg · ablation_tex
• characterization_svg · characterization_tex
• convergence_svg · convergence_tex
• critical_difference_svg · critical_difference_tex
• data_profile_svg · data_profile_tex
• ecdf_svg · ecdf_tex
• exploration_exploitation_svg · exploration_exploitation_tex
• frontier_svg · frontier_tex
• performance_profile_svg · performance_profile_tex
• ranking_svg · ranking_tex
• robustness_svg · robustness_tex
• run_order_trend_svg · run_order_trend_tex
• runtime_quality_svg · runtime_quality_tex
• scalability_svg · scalability_tex
• sensitivity_svg · sensitivity_tex
• stability_svg · stability_tex

Kontrak perbandingan:

• ComplexityRow
• EvidenceCaveat
• EvidenceCaveatScope
• HeadToHeadComparison
• HeadToHeadRow
• complexity_table_markdown
• evidence_caveats_markdown
• head_to_head_comparison

Inferensi dan ukuran efek (pengujian signifikansi deterministik, bebas-dependensi):

• friedman_test / FriedmanResult — uji peringkat omnibus Friedman atas beberapa algoritma.
• FriedmanOutcome — uji peringkat omnibus Friedman atas seluruh medan solver.
• nemenyi_critical_difference / CriticalDifference — perbedaan kritis semua-pasangan Nemenyi untuk peringkat rata-rata.
• wilcoxon_signed_rank / WilcoxonResult — uji peringkat-bertanda Wilcoxon dua-sisi untuk selisih berpasangan.
• bayesian_sign_test / BayesianSignTestResult — uji tanda Bayesian dengan suatu region of practical equivalence atas selisih berpasangan.
• bayesian_signed_rank_test / BayesianSignedRankResult — uji peringkat-bertanda Bayesian proses-Dirichlet berbenih dengan suatu region of practical equivalence atas selisih berpasangan.
• vargha_delaney_a12 / interpret_a12 — ukuran efek Vargha-Delaney A12 dan label magnitudonya.
• bca_bootstrap_interval / BootstrapInterval — interval keyakinan bootstrap terkoreksi-bias dan terakselerasi.
• standard_normal_cdf / standard_normal_ppf — distribusi kumulatif dan kuantil normal-baku.
• chi_square_sf — probabilitas ekor-atas (sintasan) khi-kuadrat.
• detectable_effect_size / required_paired_count / PowerAssessment — efek berpasangan terstandardisasi terdeteksi terkecil pada suatu jumlah run, dan kebalikannya.
• ArpdRow / arpd_rows — deviasi persentase relatif rata-rata per solver terhadap nilai referensi terbaik-diketahui yang dipasok pemanggil dengan provenans eksplisit.
• ensure_equal_budgets — verifikasi gagal-tertutup atas protokol anggaran-setara berskala-ukuran.

Registri metode-analisis (seleksi metode gagal-tertutup):

• AnalysisMethod / method_registry / method_by_id — metode bernama dengan asumsi dan lantai pengungkapannya.
• AnalysisFamily / methods_in_family — keluarga metode dan keanggotaannya.
• MethodSupport / evaluate_support — verdik dukungan gagal-tertutup untuk suatu metode pada ukuran sampel tertentu.
• MethodLimitation — sebuah metode bernama tak-didukung yang dialihkan ke permukaan keterbatasan.
• STATISTICAL_POWER_FLOOR — ukuran sampel minimum yang di bawahnya metode kurang-daya gagal-tertutup.

Frame analisis (frame baris dan seri tambahan yang dirender konsumen figur atau tabel):

• AnalysisFrames — bundel frame tambahan untuk satu dataset.
• BenchmarkRow / benchmark_rows — cakupan per-instans-tolok-ukur di seluruh medan solver.
• CharacterizationRow / characterization_rows — deskriptor kesulitan per-masalah dari spread teramati.
• ConstraintRow — satu baris akuntansi-kendala atas dataset.
• ConvergenceSeries / convergence_series — jejak objektif-terbaik per-solver menurut iterasi.
• DataProfileSeries / data_profile_series — pangsa sel per-solver yang terselesaikan hingga akurasi target dalam anggaran grup-evaluasi untuk figur profil-data.
• DiversitySeries / diversity_series — jejak diversitas-populasi per-solver menurut iterasi untuk figur keseimbangan eksplorasi-eksploitasi.
• InfeasibleRunRow / infeasible_rows — run selesai tak-layak dan kegagalan terekam yang dialihkan ke suplemen.
• OptimalityGapRow / optimality_gap_rows — celah optimalitas per-(masalah, solver) terhadap batas referensi.
• RobustnessPoint / robustness_points — CVaR + risiko-ekor kasus-terburuk per-solver atas himpunan objektif untuk figur ketegaran.
• RuntimeQualityPoint / runtime_quality_points — observasi waktu-jalan-kualitas untuk figur waktu-jalan-kualitas.
• ScalabilitySeries / scalability_series — jejak waktu-jalan-rata-rata-menurut-skala-instans per-solver untuk figur skalabilitas.
• SensitivityPoint — satu rata-rata tingkat-parameter untuk sapuan sensitivitas.
• StabilityPoint / stability_points — kestabilan-seed per-solver (koefisien variasi rata-rata) untuk figur kestabilan.
• AblationRow — satu hasil isolasi-mekanisme versus konfigurasi penuh.

Indikator multi-objektif:

• MultiObjectiveIndicatorRow / multiobjective_indicators — keempat indikator kualitas bernama per front aproksimasi solver.
• MultiObjectiveIndicatorReport / multiobjective_indicator_report — baris indikator di samping titik referensi bersama terarsip yang menghasilkannya.
• ReferencePointRule / ReferencePointRecord — aturan penurunan titik-referensi dan rekaman terarsip dengan kosakata provenans gagal-tertutupnya.
• ensure_shared_reference_points — pemeriksaan gagal-tertutup bahwa artefak yang dibandingkan berbagi satu titik referensi terarsip.
• quality_indicator_method_ids — id metode registri yang dihitung permukaan ini secara menyeluruh.

Perbandingan platform (bukti kapabilitas dan distribution-distance):

• PlatformComparison / platform_comparison_markdown — keempat himpunan baris perbandingan-platform dan Markdownnya.
• RivalFrameworkRow / rival_framework_markdown — perbandingan kapabilitas terhadap kerangka kerja saingan.
• FeatureRichnessRow / feature_richness_markdown — matriks cakupan-fitur.
• DistributionDistanceRow / distribution_distance_markdown — penilaian jembatan distribution-distance per keluarga tolok ukur.
• ArtifactInspectionRow / artifact_inspection_markdown — bukti inspeksi-artefak portal.
• EvidenceSource — bagaimana klaim suatu baris perbandingan-platform didukung.

Perancah laporan, gerbang klaim, dan redaksi:

• ReportScaffold / ReportScaffoldSpec / ReportProfile / ReportSection / CANONICAL_SECTION_ORDER / write_report_scaffold — perancah laporan deterministik, tertaut-sumber, tersaring-pengungkapan.
• ClaimGate / ClaimGateKind / ClaimGateState / ClaimGateOutcome / evaluate_claim_gate — klaim laporan tergerbang-bukti dan verdik promosinya.
• ContributionMatrix / ContributionRow / ContributionOverlap / contribution_partition — partisi kontribusi tanpa-tumpang-tindih di seluruh tingkat bukti.
• RedactionFinding / redaction_report / assert_redaction_clean — pemindaian suatu permukaan publik kandidat untuk istilah terlarang dan kebocoran lintas-tingkat.
• ReproducibilityBadge — target lencana-reproduksibilitas dan bagaimana indeks artefak memenuhinya.
• MaintenanceLedgerEntry / maintenance_ledger_markdown — permukaan ekstensi-masa-depan yang tidak boleh melemahkan batas pengungkapan.

Manifes reproduksibilitas:

• ReproducibilityManifest / build_reproducibility_manifest / reproducibility_manifest_markdown — fakta reproduksibilitas per-run dan dokumen Markdownnya.
• FIGURE_GENERATORS — registri generator figur yang direkam manifes.

Glosarium solver (permukaan penamaan bebas-metafora):

• SOLVER_OPERATIONAL_DESCRIPTIONS / solver_operational_description — deskripsi operasional bebas-metafora per solver.
• SOLVER_EQUIVALENCE_NOTES / solver_equivalence_note — catatan ekuivalensi algoritma-dikenal per solver.
• INSPIRATION_DOMAIN_TERMS / metaphor_terms_in — inventaris istilah domain-inspirasi dan deteksinya.

Registri nama-tampilan:

• BENCHMARK_DISPLAY_NAMES / benchmark_display_name — nama tampilan terdaftar untuk pengidentifikasi tolok ukur.
• SOLVER_DISPLAY_NAMES / solver_display_name — nama tampilan terdaftar untuk pengidentifikasi solver.
• ABLATION_DISPLAY_NAMES / ablation_display_name — nama tampilan untuk varian ablasi isolasi-mekanisme.
• benchmark_instance_label — sebuah label tampilan yang menjaga identitas instans tetap terlihat.
• UnknownDisplayNameError — dimunculkan ketika suatu pengidentifikasi tidak memiliki nama tampilan terdaftar.

Tingkat bukti:

• Tier / tier / TIER_REGISTRY — tingkat bukti publik dan di mana bukti setiap tingkat boleh muncul.
• UnknownTierError — dimunculkan ketika suatu pengidentifikasi tingkat tidak memiliki entri registri.

Tema figur:

• FigureTheme / DEFAULT_THEME — warna, tipografi, dan lebar kanvas yang dapat-dikendalikan-eksternal yang dibagikan di seluruh setiap keluarga bagan.