DispatchAtlasReferência da API
A API pública é agrupada por distribuição. Importe a partir do namespace mais
estreito que detém o comportamento. As listas abaixo espelham as exportações
atuais do namespace público para que os leitores possam auditar a superfície de
importação suportada sem ler os arquivos __init__.py do pacote.
📦 Distribuição Raiz
Use dispatchatlas.version para a superfície leve de versão do pacote raiz:
__version__
🧱 Núcleo
dispatchatlas.core é a fronteira interna do pacote. Ele exporta objetos de
domínio, validação, proveniência, serialização, semente, sistema de arquivos,
registro de logs e contratos de protocolo.
Contratos de configuração:
FoundationConfigSeedPolicySerializationFormatValidationMode
Contratos de erro:
DataQualityErrorDispatchAtlasErrorDomainValidationErrorInfeasibleScheduleErrorMissingOptionalDependencyErrorProvenanceErrorScheduleValidationErrorSeedDerivationErrorSerializationContractErrorUnsupportedCapabilityErrorrequire_finite— retorna o valor convertido para um ponto flutuante finito ou levanta o contrato de erro fornecido quando ele é NaN ou infinito.require_non_negative_int— retorna o inteiro ou levanta o contrato de erro fornecido quando ele é negativo.require_positive_int— retorna o inteiro ou levanta o contrato de erro fornecido quando ele não é positivo.require_text— retorna o texto sem espaços nas extremidades ou levanta o contrato de erro fornecido quando ele está em branco.
Auxiliares de sistema de arquivos:
read_text_resilientsafe_child_directorysafe_directory_namesafe_namespaced_idwrite_json_artifactwrite_json_artifact_atomicwrite_text_artifactwrite_text_artifact_atomic
Observabilidade (registro de logs centralizado):
get_loggermake_formatterconsole_handlerfile_handlerscoped_loggingconfigure_root_loggingMESSAGE_FORMATCONSOLE_FORMATSTRUCTURED_FORMATDEFAULT_DATEFMTROOT_LOGGER_NAME
Contratos de manifesto de campanha:
CampaignCheckpointManifestCampaignFailureRecordCampaignRunRecordcampaign_checkpoint_from_jsonablecampaign_checkpoint_to_jsonablecampaign_failure_record_from_jsonablecampaign_failure_record_to_jsonablecampaign_run_record_from_jsonablecampaign_run_record_to_jsonable
Contratos do modelo de escalonamento:
AssignmentConstraintConstraintKindDependencyDependencyKindDurationMetadataObjectiveObjectiveSenseObjectiveValueParityBasisProblemIdProblemSpecResourceAmountResourceIdResourceRequirementResourceSpecScheduleScheduleResultScheduleStatusTaskIdTaskModeTaskSpecTimePointmetadata_items
Protocolos de integração:
AnalysisExporterBenchmarkDescriptorBenchmarkProviderDisclosureLabelDisclosurePolicyExperimentPlanExperimentResultExperimentRunnerResultRepositorySolverSolverDescriptorSolverRun
Contratos de proveniência:
ArtifactHashCitationStatusEnvironmentStampEvidenceClassPackageRecordProvenanceQualityGateStatusSeedLineageSourceReferencehash_bytesutc_now
Contratos de semente:
MAX_SEEDSEED_DOMAIN_SEPARATORSeedSeedStreamderive_seed
Contratos de serialização:
ArtifactEnvelopecanonical_json_bytesdumps_envelopeenvelope_artifactenvelope_from_jsonableenvelope_to_jsonableenvironment_from_jsonableenvironment_to_jsonableloads_envelopeproblem_from_jsonableproblem_to_jsonableprovenance_from_jsonableprovenance_to_jsonableschedule_from_jsonableschedule_to_jsonable
Contratos de validação:
ValidatedProblemValidationIssueValidationReportValidationSeverityValidationStampcollect_problem_issuescollect_schedule_issuesvalidate_problemvalidate_schedule
Constantes de dimensionamento do núcleo:
DEFAULT_CPU_RESERVE— CPUs retidas do pool de workers por padrão.DEFAULT_MEMORY_RESERVE_FRACTION— a fração da memória do sistema mantida em reserva por padrão.OBJECTIVE_FAMILY— o registro que mapeia cada tipo de objetivo à sua definição canônica.
Concorrência do host:
available_cpu_count/available_system_memory_bytes— as CPUs disponíveis para este processo e a melhor estimativa de memória do sistema disponível.maximal_safe_worker_count— a contagem máxima segura de workers paralelos para o host.
Modelo contínuo (edge–fog–cloud):
ComputeTier— uma camada de computação do contínuo (edge, fog, cloud) com sua capacidade agregada.NetworkTopology/NetworkLink— o tecido de comunicação e seus enlaces direcionados entre camadas.Bandwidth/DataVolume— vazão positiva de enlace em bytes por segundo e dados transferíveis não negativos em bytes.PlacementAffinity— a preferência de uma tarefa por um alvo de alocação no contínuo.
Modelo de custo (R||Cmax, comunicação, execução dependente de carga, configuração dependente de sequência):
CostModel/cost_model_from_jsonable/cost_model_to_jsonable— o conjunto do modelo de custo vinculado a um problema por identificador, e sua serialização.ExecutionTimeMatrix/ExecutionTimeEntry/execution_matrix_from_iterable— a matriz de tempos de execução de máquinas não relacionadas (p_ij).CompatibilityMask— o conjunto explícito de elegibilidade de tarefa para máquina.CommunicationModel/CommunicationLink— penalidades de comunicação entre recursos em um grafo esparso.LoadModel/LoadModelKind/LoadBreakpoint— a curva de execução dependente de carga e sua interpolação entre pontos de quebra.SetupMatrix/SetupEntry/SetupReferenceKind— tempos de configuração dependentes de sequência indexados por transição e máquina.
Família de objetivos:
ObjectiveKind/ObjectiveDefinition/objective_definition— objetivos de escalonamento nomeados e seus metadados canônicos.ObjectiveReduction/VectorObjectiveValue— a regra de escalarização e um vetor multi-objetivo medido com metadados de divulgação.vector_objective_from_jsonable/vector_objective_to_jsonable— serialização de objetivo vetorial.
Avaliação de objetivos:
evaluate_objective/evaluate_objectives/ObjectiveEvaluation— avalia um ou cada objetivo nomeado sobre um escalonamento.MultiObjectiveOutcome/computed_vector/multi_objective_outcome_from_jsonable— objetivos escalares e vetoriais mais a viabilidade de um escalonamento.EvaluationStatus/objective_sense— se um valor foi calculado ou adiado, e o sentido de otimização de um objetivo.
Viabilidade e restrições:
FeasibilityReport/build_feasibility_report— linhas de violação rígida mais a contabilidade de penalidades de restrições brandas.InfeasibleRow/SoftConstraintPenalty— uma violação rígida visível ao revisor e uma penalidade ponderada de restrição branda.ServiceLevelConstraint/ServiceLevelOutcome/evaluate_service_level/evaluate_service_level_over_schedule/resolve_metric— restrições de nível de serviço nomeadas sobre uma métrica de escalonamento e sua avaliação.ConstraintViolationSummary/summarize_constraints— contabilidade agregada de restrições rígidas, brandas e de nível de serviço.
Frente de Pareto e indicadores de qualidade:
dominates/to_minimization— dominância de Pareto sob minimização e conversão de sentido misto.fast_non_dominated_sort/non_dominated_front/non_dominated_indices— ordenação não dominada NSGA-II e o conjunto não dominado.FrontierPoint/LabelledPoint/frontier_data— vetores de objetivo rotulados e registros prontos para a frente.hypervolume/igd_plus/additive_epsilon_indicator/spread— os quatro indicadores de qualidade: hipervolume, IGD+, epsilon aditivo e espalhamento por vizinho mais próximo.QualityIndicatorReport/quality_indicator_report— todos os quatro indicadores para uma frente em relação a um conjunto de referência.
Robustez:
PerturbationScenario/PerturbationSet— cenários de perturbação nomeados para um objetivo.RobustnessAggregation/RobustnessValue/evaluate_robustness— como um conjunto de perturbações se agrega em um número de robustez com sua base declarada.
Manifestos de execução:
RunTiming/ResourceUsage/SolverCounters— tempo de relógio e tempo anytime, uso máximo de recursos e contadores de esforço do solver para uma execução.ConvergenceSample/TimedObjectiveSample— valores de objetivo observados em uma contagem de iterações e em um deslocamento de tempo de relógio.
Encerramento:
TerminationPolicy— uma política de parada de solver multi-critério e componível.
Segurança de sistema de arquivos:
safe_path_under_root— um caminho retornado apenas quando resolve abaixo de uma raiz autorizada.
Serialização do contínuo:
bandwidth_from_jsonable/bandwidth_to_jsonablecompute_tier_from_jsonable/compute_tier_to_jsonabledata_volume_from_jsonable/data_volume_to_jsonablenetwork_link_from_jsonable/network_link_to_jsonablenetwork_topology_from_jsonable/network_topology_to_jsonableplacement_affinity_from_jsonable/placement_affinity_to_jsonable
🧪 Benchmarks
dispatchatlas.bench exporta catálogos de benchmark, geradores de famílias
genéricas e do contínuo, metadados de gerador, materialização, validação de
citações, caracterização, métricas de dureza e de lacuna de realidade, seleção,
download e contratos de taxonomia.
Contratos de catálogo:
StaticBenchmarkProviderbenchmark_provider_for_selectorsbuild_feasibility_diagnostic_catalogbuild_full_catalogbuild_smoke_catalogfull_benchmark_providerfull_catalog_configssmoke_benchmark_providersmoke_catalog_configs
Contratos de caracterização:
CharacterizationMetricsCharacterizationReportcharacterize_problem
Contratos de citação:
CitationClaimCitationMatrixSourceKinddefault_citation_matrixvalidate_citation_matrix
Contratos de gerador:
BenchmarkGeneratorDagWorkflowGeneratorGeneratorRegistryIndependentTaskGeneratorcloud_edge_profiledefault_registryworkflow_profile
Contratos de materialização:
BenchmarkInstanceBenchmarkInstanceSetCatalogManifestCatalogManifestEntryconfig_to_jsonablemanifest_to_jsonablematerialize_benchmarkmaterialize_with_generatorwrite_instance_set
Contratos de metadados:
BenchmarkConfigDomainProfileGeneratorMetadataScaleSpec
Contratos de família genérica:
CostModelGeneratorGenericFamilyGeneratorflexible_job_shop_generatorflow_shop_generatorgeneric_family_full_configsgeneric_family_generatorsgeneric_family_smoke_configsjob_shop_generatormachine_scheduling_generatorrcpsp_generatorsetup_flow_shop_generator
Contratos de família do contínuo:
ContinuumFamilyGeneratorContinuumFamilySpecContinuumScenarioContinuumStratumDistinctivenessRecordbuild_continuum_catalogbuild_continuum_full_catalogcontinuum_family_distinctivenesscontinuum_family_full_configscontinuum_family_generatorscontinuum_family_smoke_configscontinuum_family_specs
Contratos de dureza:
HardnessAxisHardnessSpechardness_axishardness_axis_registrymeasured_communication_compute_ratiomeasured_deadline_slack_ratiomeasured_dependency_densitymeasured_duration_cvmeasured_fabric_churnmeasured_offload_deceptionmeasured_release_stagger
Contratos de lacuna de realidade:
MAX_DISTRIBUTION_DISTANCEDistributionDistanceBridgeDistributionDistanceScoreDistributionDistanceStatusdefault_distribution_distance_bridgesmetrics_from_instance_setper_feature_wassersteindistribution_distance_scorevalidate_distribution_distance_bridge
Contratos de seleção:
DifficultyStratumSubsetCriteriadifficulty_scoredifficulty_stratuminstance_familyinstance_profile_classselect_benchmark_subsetstratify_instances
Contratos de metadados de catálogo e download:
CATALOG_SCALAR_COLUMNSCatalogInstanceMetadataDownloadFormatcatalog_instance_metadatacatalog_instance_to_jsonablecatalog_instance_to_rowcatalog_metadata_for_instancescatalog_metadata_for_setscatalog_subset_from_bundlecatalog_subset_from_csvcatalog_subset_from_jsoncatalog_subset_to_bundlecatalog_subset_to_csvcatalog_subset_to_jsonselect_catalog_metadataserialize_catalog_subset
Contratos de taxonomia:
DEFAULT_TAXONOMYBenchmarkTaxonomyBenchmarkTierConstraintFeatureDynamismFeatureEnvironmentDomainInfrastructureRealismObjectiveFeatureProfileClassSchedulingFamilySchedulingStructureUncertaintyFeature
Contratos de registro de suíte-de-referência:
InstanceCountStatusReferenceSuiteSuiteFormatdefault_reference_suitesreference_suitevalidate_reference_suites
Contratos de melhor-solução-conhecida:
BestKnownIngestBestKnownKindBestKnownRegistryBestKnownValueload_best_knownload_best_known_registry
Contratos de ingestão de instância-canônica:
SUPPORTED_FORMATSParseContextParsedInstanceReferenceSuiteGeneratorload_reference_suiteparse_fjsparse_standard_jspparse_taillard_pfspparse_wfformat_jsonreference_suite_configreference_suite_distribution_distance_bridge
🧮 Solvers
dispatchatlas.solve exporta metadados de solver, registros, linhas de base
construtivas, metaheurísticas, variantes NDSO, operadores, adaptadores opcionais
e auxiliares de perfilamento.
Contratos de linha de base e execução:
DispatchRuleDispatchingSolverOrderRunRequestTerminationTracker— o avaliador com estado, do tipo primeiro-a-disparar, que consolida o progresso de um laço de busca em umaTerminationPolicye reporta qual critério encerrou a execução.baseline_solversneh_order— a ordem de construção-por-inserção NEH (Nawaz–Enscore–Ham).
Contratos de metadados de solver:
DependencyRequirementSolverCapabilitySolverDescriptorSpecSolverFamilySolverMetadataStochasticity
Contratos de metaheurística:
MetaheuristicKindPermutationMetaheuristicSolverPermutationSearchConfigmetaheuristic_solvers
Contratos de escalonamento-por-lista baseado-em-posto:
ListSchedulingRankListSchedulingSolverlist_scheduling_solversheft_profile— escalonamento-por-lista de posto-ascendente (HEFT).cpop_profile— escalonamento-por-lista de posto ascendente+descendente combinado (CPOP).peft_profile— escalonamento-por-lista de tabela-de-custo-otimista (PEFT).
Contratos de regra-de-mapeamento de conjunto-pronto:
MappingRuleMappingRuleSolvermapping_rule_profilemapping_rule_solvers— as regras em lote min-min, max-min e sufferage.
Contratos de competidor multi-objetivo de Pareto:
NSGA2ConfigNSGA2SolverMOEADConfigMOEADSolvernsga2_profilemoead_profilemulti_objective_solverscrowding_distances— o estimador de densidade de distância-de-aglomeração do NSGA-II.nsga2_environmental_selection— sobrevivência elitista posto-depois-aglomeração.tchebycheff— a função escalarizante de Tchebycheff do MOEA/D.
Contratos de guloso-iterado:
ITERATED_GREEDY_RS_CITATIONIteratedGreedyRSConfigIteratedGreedyRSSolver— a configuração canônica de destruição–construção para flow shops de permutação.iterated_greedy_rs_profileiterated_greedy_rs_solvers
Contratos de tabu de caminho-crítico:
CriticalPathTabuConfigCriticalPathTabuSolvercritical_path_tabu_profilecritical_path_tabu_solverscritical_pairs— o gerador de vizinhança de pares-adjacentes do caminho-crítico.
Contratos de escalonamento-de-projeto (SGS serial):
SerialSGSJustificationSolver— geração serial de escalonamento com dupla justificação para escalonamento de projeto com recursos-restritos.serial_sgs_justification_profileserial_sgs_justification_solversdouble_justified_order— a passagem de justificação para-trás–para-frente.latest_finish_order— a ordem de prioridade por tempo-de-término-mais-tardio.
Contratos NDSO:
NDSOAblationNDSOMechanismsNDSOSolverNDSOVariantndso_ablation_catalogndso_solvers
Contratos de operador de escalonamento:
BatchScoreResultScheduleMetricsadjacent_swap_neighborbatch_score_ordersconstruct_scheduleearliest_finish_task_orderlocal_search_ordernormalize_task_orderobjective_values_forrandom_topological_task_orderrepair_scheduleschedule_metricsscore_orderscore_scheduletopological_task_order
Contratos de adaptador opcional:
OptionalExactSolveroptional_solversortools_dependency
Contratos de desempenho:
BatchScoringProfileProfiledResultprofile_call
Contratos de registro:
ProfiledSolverSolverRegistrydefault_solver_registry
Constantes de ajuste de solver:
NATIVE_EXACT_TASK_CAP— o teto de contagem de tarefas acima do qual o solver exato nativo falha de forma fechada.RUN_COUNT_FLOOR— a contagem mínima de execuções repetidas que uma comparação justa exige.VELOCITY_WINDOW— a janela de velocidade de melhoria que o controlador anytime observa.IMPROVEMENT_FLOOR— a melhoria relativa mínima que conta como progresso.FEATURE_ORIGIN— a métrica da plataforma de benchmark da qual cada atributo de seleção deriva.
Famílias de despacho de linha de base:
DispatchingFamilySpec— uma família de despacho nomeada vinculada a uma regra de prioridade determinística.RetiredFamily/RetirementReason/retired_dispatching_families— famílias nomeadas deliberadamente deixadas de lado, cada uma com sua justificativa.
Concorrentes diversificados (o campo de metaheurísticas nomeado):
CompetitorKind/CompetitorSolver/CompetitorConfig— concorrentes nomeados com parâmetros de busca limitada compartilhados.competitor_solvers/diversified_competitors— o conjunto de concorrentes diversificado e ciente de divulgação.post_2020_currency_anchor— as referências de âncora de atualidade pós-2020 para o campo.recent_peer_strength_bar— os pares recentes retidos sob a barra de força de publicação.
Otimizadores contínuos (decodificados sobre a ordem discreta):
clpso_optimize/CLPSOConfig— otimização por enxame de partículas com aprendizado abrangente.lshade_optimize/LSHADEConfig— evolução diferencial adaptativa por histórico de sucessos com redução linear de população.EncodedSolverKind/EncodedAdapterSolver/encoded_adapter_solvers— a família contínua vinculada a um adaptador de codificação discreta.ContinuousResult/SearchBudget— o resultado de uma execução contínua e seu orçamento de iteração, aleatoriedade e tempo de relógio.
Codificação de contínuo para discreto:
EncodingAdapter/encoding_adapter/encoding_adapter_catalog— codificações nomeadas de contínuo para discreto com reparo explícito.DecodeRule/DecodeOutcome— a regra que transforma um vetor-chave transformado em uma ordem de tarefas, e seu resultado reparado.RepairPolicy— a política que restaura a viabilidade de precedência após a decodificação.TransferFunction— a função de compressão que mapeia uma componente contínua a um sinal de seleção.
Solvers exatos:
ExactMethod/ExactSolver— métodos exatos nomeados e um adaptador que falha de forma fechada com um backend ausente ou uma entrada de tamanho excessivo.ExactAdapterSpec/exact_adapter_specs/exact_solvers— os contratos de adaptador de solver exato empacotados.
Concorrente de muitos objetivos (NSGA-III):
NSGA3Solver/NSGA3Config/nsga3_solvers/nsga3_profile— o concorrente NSGA-III sobre ordens seguras quanto à precedência.nsga3_reference_points— pontos de referência estruturados de Das & Dennis no simplex unitário.nsga3_environmental_selection— seleção por nicho de ponto de referência NSGA-III.
Variantes de escalonamento acadêmicas:
SchedulingVariantKind/PermutationSchedulingVariantSolver/SchedulingVariantConfig— variantes híbridas acadêmicas nomeadas sobre a codificação de ordem discreta.scheduling_variant_solvers— as linhas de base de variante de escalonamento de primeira classe.
Seleção de algoritmo:
RuleBasedSelector— uma linha de base apenas para benchmark que classifica candidatos somente a partir de metadados.SupervisedSelector— um seletor aprendido determinístico do vizinho mais próximo ponderado por distância.SelectionFeature/SelectionFeatures/feature_origin— os atributos de caracterização nomeados que o seletor consome e sua origem.SelectionLabel/SolverRecommendation/RecommendationSource— exemplos de treinamento rotulados e recomendações classificadas com confiança e limitações.
Validação cruzada do seletor (generalização sem vazamento):
cross_validate/GeneralizationReport— generalização em conjunto de teste deixando uma família de fora sobre um corpus.leave_one_family_out/partition_by_families/TrainTestSplit— divisões de treino/teste disjuntas por família.held_out_generalization— treina na metade de treino da divisão e reporta a acurácia top-1 em sua metade de teste.leakage_report/LeakageReport— as sobreposições de instância, família e registro de caracterização que uma divisão sem vazamento deve manter vazias.validated_supervised_selector— um seletor cuja confiança reflete sua generalização em conjunto de teste.
Interfaces de aprendizado e híbridas (opcionais, falham de forma fechada):
LearningInterfaceKind/LearningInterface/learning_interface/learning_interface_catalog— interfaces de aprendizado e híbridas nomeadas com status, política e contingência.InterfaceStatus/LearningEvidencePolicy— o status de ciclo de vida e o contrato de evidência que cada uma dessas superfícies declara.ConfidenceLabel/confidence_rank— a confiança que uma recomendação pode carregar e sua força ordinal.learning_backend_available/learning_dependency/require_learning_backend— o backend de aprendizado opcional (um extra, nunca um padrão) e seu erro de dependência ausente tipado.
Metadados de solver e citações:
Citation/CitationStatus— uma referência seminal canônica (ou uma justificativa explícita de não aplicabilidade) e se uma família carrega uma.SolverEncoding— a codificação de solução sobre a qual um solver busca ou constrói.SUMMIT_EVIDENCE_LABEL— o rótulo de contexto de divulgação para metadados, evidências e exportações.
Superfície da família NDSO:
NDSOFamilySolver— a superfície comum de todo solver da família NDSO, enxame único ou conselho.fast_mechanisms— o conjunto fixo de mecanismos da composição rápida.
Mecanismos NDSO (construção com validade por design):
PrecedenceIndex/precedence_index— conjuntos de predecessores e uma ordenação estável de tarefas que todo construtor usa.GuidanceSource/GuidanceContext/select_guidance— as três fontes de Tripla Orientação e as entradas de construção compartilhadas de um candidato.guided_construction— constrói um candidato viável a partir de uma ordem de orientação.confidence_weighted_elite— forja a Elite por Votação Ponderada por Confiança.ConfidenceMatrix/consolidate_confidence/latent_archive— confiança aprendida por célula, sua consolidação entre enxames e células confiantes que a Elite abandonou.quality_guidance/quantity_update/BetaSchedule— as regras de qualidade e quantidade e o coeficiente adaptativo unificado.rank_reward— uma recompensa derivada de classificação em [0, 1].
Conselho Inter-Enxame NDSO:
NDSOSummitSolver/summit_solver/summit_profile/SummitConfig— o conselho Inter-Enxame, a composição de qualidade da família.CouncilTopology— a topologia de troca inter-enxame que conecta os enxames do conselho.SummitDiagnostics— o resumo imutável de coordenação do conselho anexado a uma execução.
Ablação de mecanismos NDSO:
AblationEntry/ablation_map— uma ablação isolante por mecanismo canônico.build_ablation_solver/run_ablation_suite/AblationRunResult— construir e executar cada ablação isolante limitada por viabilidade.ABLATION_STATISTICAL_PLAN/StatisticalTestPlan— os testes estatísticos da camada de análise nomeados que uma comparação de ablação usa.
Controle anytime NDSO:
AnytimeController/AnytimeReport— o controlador de encerramento antecipado por velocidade de melhoria e seu registro de atividade.
Diagnósticos NDSO:
DiagnosticsCollector/DiagnosticsSnapshot— um gravador de convergência opcional, de sobrecarga zero quando desabilitado, e seu resumo.IterationTrace— o registro de convergência de uma iteração.population_diversity— a discordância média de posição entre pares em [0, 1].
Divulgação NDSO (controle de mecanismos que falha de forma fechada):
MechanismDescriptor/mechanism_descriptor/mechanism_catalog— mecanismos nomeados e o piso de divulgação ao qual cada um pertence.DisclosureFilter/DisclosureViolationError— o controle que falha de forma fechada sobre quais mecanismos um escopo de relatório pode expor.ReportScope/EvidenceProgram— escopos de relatório em etapas e os quatro programas de evidência em etapas mapeados a um piso de divulgação.base_disclosure_filter/program_disclosure_filter— os filtros de escopo base e por programa que falham de forma fechada.blocks_summit_evidence— se o filtro de um programa bloqueia o piso de qualidade exclusivo do conselho.
🚀 Campanhas
dispatchatlas.lab exporta configuração de campanha reproduzível, contratos de
orçamento, ambiente, repositório, falha e execução.
Contratos de orçamento:
CampaignBudgetReportdry_run_campaign
Contratos de configuração:
FULL_CAMPAIGN_BLOCKERBudgetScalingCampaignConfigCampaignPlanCampaignRunSpecCampaignStageExecutionModeFailureCategoryOutputPolicyResourceBudgetRetryPolicycampaign_config_hashconfig_to_jsonableplan_to_jsonable
Contratos de ambiente:
capture_campaign_environment
Contratos de erro:
BudgetEstimationErrorCampaignConfigErrorCampaignExecutionErrorCheckpointRecoveryErrorEnvironmentCaptureError
Contratos de repositório:
CampaignResultIndexCheckpointManifestFailureRecordFileResultRepositoryRunRecord
Contratos de runner:
CampaignRunnerclassify_failuredefault_campaign_runnerresume_campaignrun_campaignvalidate_campaign
Configuração de campanha:
CampaignKind— a classe de design experimental que uma campanha realiza.StoppingProtocol/StoppingProtocolKind— um protocolo de parada nomeado e reportável de forma independente para um relatório de solver estocástico.RunCountPolicy/STATISTICAL_POWER_FLOOR— a política de contagem de execuções e a contagem mínima de réplicas abaixo da qual as execuções de um solver são sinalizadas como subdimensionadas em poder.TuningBudget— o orçamento de ajuste igual por algoritmo que mantém uma comparação justa.campaign_config_from_jsonable— re-hidrata uma configuração de campanha validada a partir de dados compatíveis com JSON.
Resolução de contagem de execuções:
ReplicateResolution/resolve_replicates— a contagem de réplicas resolvida para um solver, com qualquer sinalização de subpoder, sob a política de contagem de execuções.
Invariante de comparação justa:
assert_fair_comparison— valida as pré-condições estruturais do invariante de comparação justa.fair_comparison_manifest— as linhas de manifesto que registram a garantia de comparação justa.
Configurações de motor (resolução em quatro camadas com carimbo de proveniência):
EngineSettings/resolve_engine_settings— os ajustes de motor resolvidos nas quatro camadas de configuração, cada campo carimbado com proveniência.ResolvedSetting/SettingSource— o valor de um ajuste emparelhado com a camada que o forneceu.apply_environment_overrides— sobrepõe a camada de ambiente a uma configuração de campanha de arquivo ou de chamada.
Topologia de workers e agregação:
WorkerTopology/topology_for_plan/probe_capacity— a topologia de workers que respeita o orçamento, selecionada para uma campanha após sondar a capacidade do host.AggregateManifest/merge_only_aggregation— agregação determinística somente por mesclagem dos registros de execução concluídos em um único hash de campanha estável em bits.
Atlas de experimentos:
ExperimentAtlas/default_experiment_atlas— um atlas ciente de divulgação das trilhas de evidência detidas.EvidenceTrack— uma fatia de evidência detida no atlas de experimentos.
Matriz de aplicabilidade família-de-benchmark por solver:
ApplicabilityMatrix/default_applicability_matrix— a matriz completa de aplicabilidade família-de-benchmark por solver, derivada dos registros ativos e então anotada pela tabela de substituição.ApplicabilityCell— uma declaração de aplicabilidade(família de benchmark, solver)que carrega seu status, justificativa e um ponteiro de evidência opcional.ApplicabilityStatus— o enum de status por-célula verificado / aproximado / não-aplicável.ApplicabilityEvidence/ApplicabilityEvidenceKind— um ponteiro de evidência seguro-para-o-portal (campanha, citação ou teste) e sua classe de proveniência.ApplicabilityOverride/default_applicability_overrides— uma atualização manual revisável de uma célula derivada, e a tabela de substituição no código onde vivem as células verificadas.SchedulingFamilyCell— uma consolidação família-de-escalonamento por solver que agrega as células de família-de-benchmark constituintes.derive_applicability_cell— deriva uma célula aproximada-ou-não-aplicável a partir de metadados declarados.constraint_capability_bridge— a ponte tipada de recurso-de-restrição para tag-de-capacidade (fonte única de verdade).ApplicabilityScreen/screen_campaign_applicability— filtra um produto-cruzado de campanha planejada contra a matriz, reportando pares bloqueados, aproximados e verificados.
📊 Análise
dispatchatlas.analytica exporta filtragem de divulgação, ingestão, resumos
estatísticos, escritores determinísticos de tabelas Markdown, dezesseis famílias de
gráficos cada uma renderizada em formato duplo (SVG temável e PGFPlots .tex
editável), pacotes de evidência e conjuntos de dados do portal.
Contratos de divulgação:
DisclosureExclusionDisclosureFilterResultDisclosurePolicyEvidenceTierdefault_disclosure_policyensure_dataset_allowedfilter_dataset
Contratos de exportação:
ExportBundleevidence_bundle_directorywrite_evidence_bundlewrite_portal_dataset
Contratos de ingestão:
PlanRunFactsload_campaign_datasetload_result_dataset
Contratos de modelo:
AnalysisConfigAnalysisDatasetAnalysisSummaryCampaignManifestCorrectionMethodExportSurfaceFailureObservationObjectiveObservationPairwiseComparisonRankEntryRunObservationSolverSummary
Contratos estatísticos:
bootstrap_mean_intervalcliffs_deltacohens_dpaired_cohens_dzpaired_observation_countssummarize_datasettwo_sided_sign_test
Contratos de tabela:
ablation_table_markdownarpd_markdownbenchmark_table_markdownconstraints_table_markdownensure_effect_sizes_beside_p_valuesinfeasible_rows_markdownmultiobjective_indicators_markdownoptimality_gap_table_markdownpairwise_comparison_markdownportal_csvranking_markdownsensitivity_table_markdownsolver_summary_markdown
Contratos de visualização (cada família de gráficos renderiza como SVG temável e PGFPlots .tex editável):
ablation_svg·ablation_texcharacterization_svg·characterization_texconvergence_svg·convergence_texcritical_difference_svg·critical_difference_texdata_profile_svg·data_profile_texecdf_svg·ecdf_texexploration_exploitation_svg·exploration_exploitation_texfrontier_svg·frontier_texperformance_profile_svg·performance_profile_texranking_svg·ranking_texrobustness_svg·robustness_texrun_order_trend_svg·run_order_trend_texruntime_quality_svg·runtime_quality_texscalability_svg·scalability_texsensitivity_svg·sensitivity_texstability_svg·stability_tex
Contratos de comparação:
ComplexityRowEvidenceCaveatEvidenceCaveatScopeHeadToHeadComparisonHeadToHeadRowcomplexity_table_markdownevidence_caveats_markdownhead_to_head_comparison
Inferência e tamanhos de efeito (teste de significância determinístico e sem dependências):
friedman_test/FriedmanResult— teste de classificação omnibus de Friedman sobre múltiplos algoritmos.FriedmanOutcome— teste de classificação omnibus de Friedman sobre todo o campo de solvers.nemenyi_critical_difference/CriticalDifference— diferença crítica de Nemenyi entre todos os pares para classificações médias.wilcoxon_signed_rank/WilcoxonResult— teste de postos com sinais de Wilcoxon bilateral para diferenças pareadas.bayesian_sign_test/BayesianSignTestResult— teste de sinal bayesiano com uma região de equivalência prática sobre diferenças pareadas.bayesian_signed_rank_test/BayesianSignedRankResult— teste bayesiano de postos com sinais por processo de Dirichlet semeado com uma região de equivalência prática sobre diferenças pareadas.vargha_delaney_a12/interpret_a12— tamanho de efeito A12 de Vargha-Delaney e seu rótulo de magnitude.bca_bootstrap_interval/BootstrapInterval— intervalo de confiança bootstrap corrigido por viés e acelerado.standard_normal_cdf/standard_normal_ppf— distribuição cumulativa e quantil da normal padrão.chi_square_sf— probabilidade de cauda superior (sobrevivência) qui-quadrado.detectable_effect_size/required_paired_count/PowerAssessment— o menor efeito pareado padronizado detectável a uma contagem de execuções, e seu inverso.ArpdRow/arpd_rows— desvio percentual relativo médio por solver contra valores de referência melhor-conhecidos fornecidos pelo chamador com proveniência explícita.ensure_equal_budgets— verificação que falha fechando do protocolo de orçamento-igual escalado-por-tamanho.
Registro de métodos de análise (seleção de método que falha de forma fechada):
AnalysisMethod/method_registry/method_by_id— métodos nomeados com suas suposições e pisos de divulgação.AnalysisFamily/methods_in_family— famílias de métodos e sua composição.MethodSupport/evaluate_support— o veredito de suporte que falha de forma fechada para um método em um dado tamanho de amostra.MethodLimitation— um método nomeado não suportado encaminhado à superfície de limitações.STATISTICAL_POWER_FLOOR— o tamanho mínimo de amostra abaixo do qual métodos subdimensionados em poder falham de forma fechada.
Quadros de análise (quadros auxiliares de linha e série que um consumidor de figura ou tabela renderiza):
AnalysisFrames— o pacote de quadros auxiliares para um conjunto de dados.BenchmarkRow/benchmark_rows— cobertura por instância de benchmark através do campo de solvers.CharacterizationRow/characterization_rows— descritores de dificuldade por problema a partir do espalhamento observado.ConstraintRow— uma linha de contabilidade de restrições sobre o conjunto de dados.ConvergenceSeries/convergence_series— traços do melhor objetivo por solver ao longo das iterações.DataProfileSeries/data_profile_series— fração de células resolvidas por solver a uma acurácia-alvo dentro de um orçamento de grupos de avaliação para a figura de perfil-de-dados.DiversitySeries/diversity_series— traços de diversidade populacional por solver ao longo das iterações para a figura de equilíbrio exploração-explotação.InfeasibleRunRow/infeasible_rows— execuções concluídas inviáveis e falhas registradas encaminhadas aos suplementos.OptimalityGapRow/optimality_gap_rows— lacunas de otimalidade por (problema, solver) em relação aos limites de referência.RobustnessPoint/robustness_points— CVaR por solver mais risco de cauda de pior caso sobre o conjunto de objetivos para a figura de robustez.RuntimeQualityPoint/runtime_quality_points— observações de tempo-qualidade para a figura de tempo-qualidade.ScalabilitySeries/scalability_series— traços de tempo-médio-por-escala-de-instância por solver para a figura de escalabilidade.SensitivityPoint— uma média por nível de parâmetro para uma varredura de sensibilidade.StabilityPoint/stability_points— estabilidade de semente por solver (coeficiente de variação médio) para a figura de estabilidade.AblationRow— um resultado de isolamento de mecanismo versus a configuração completa.
Indicadores multi-objetivo:
MultiObjectiveIndicatorRow/multiobjective_indicators— os quatro indicadores de qualidade nomeados por frente de aproximação de cada solver.MultiObjectiveIndicatorReport/multiobjective_indicator_report— linhas de indicadores ao lado do ponto de referência compartilhado arquivado que as produziu.ReferencePointRule/ReferencePointRecord— as regras de derivação do ponto de referência e o registro arquivado com seu vocabulário de proveniência que falha fechando.ensure_shared_reference_points— verificação que falha fechando de que os artefatos comparados compartilham um ponto de referência arquivado.quality_indicator_method_ids— os ids de método do registro que esta superfície computa de ponta a ponta.
Comparação de plataforma (evidência de capacidade e de lacuna de realidade):
PlatformComparison/platform_comparison_markdown— os quatro conjuntos de linhas de comparação de plataforma e seu Markdown.RivalFrameworkRow/rival_framework_markdown— comparação de capacidade em relação a um framework rival.FeatureRichnessRow/feature_richness_markdown— a matriz de cobertura de atributos.DistributionDistanceRow/distribution_distance_markdown— a avaliação da ponte de lacuna de realidade por família de benchmark.ArtifactInspectionRow/artifact_inspection_markdown— a evidência de inspeção de artefatos do portal.EvidenceSource— como a afirmação de uma linha de comparação de plataforma é sustentada.
Estruturação de relatório, controles de afirmação e redação:
ReportScaffold/ReportScaffoldSpec/ReportProfile/ReportSection/CANONICAL_SECTION_ORDER/write_report_scaffold— estruturas de relatório determinísticas, vinculadas à fonte e filtradas por divulgação.ClaimGate/ClaimGateKind/ClaimGateState/ClaimGateOutcome/evaluate_claim_gate— afirmações de relatório controladas por evidência e seus vereditos de promoção.ContributionMatrix/ContributionRow/ContributionOverlap/contribution_partition— uma partição de contribuição sem sobreposição entre camadas de evidência.RedactionFinding/redaction_report/assert_redaction_clean— varredura de uma superfície pública candidata em busca de termos proibidos e vazamentos entre camadas.ReproducibilityBadge— um alvo de selo de reprodutibilidade e como o índice de artefatos o satisfaz.MaintenanceLedgerEntry/maintenance_ledger_markdown— superfícies de extensão futura que não devem enfraquecer a fronteira de divulgação.
Manifesto de reprodutibilidade:
ReproducibilityManifest/build_reproducibility_manifest/reproducibility_manifest_markdown— os fatos de reprodutibilidade por execução e seu documento Markdown.FIGURE_GENERATORS— o registro de geradores de figuras que o manifesto registra.
Glossário de solvers (superfície de nomenclatura sem metáforas):
SOLVER_OPERATIONAL_DESCRIPTIONS/solver_operational_description— a descrição operacional sem metáforas por solver.SOLVER_EQUIVALENCE_NOTES/solver_equivalence_note— a nota de equivalência de algoritmo conhecido por solver.INSPIRATION_DOMAIN_TERMS/metaphor_terms_in— o inventário de termos do domínio de inspiração e sua detecção.
Registros de nomes de exibição:
BENCHMARK_DISPLAY_NAMES/benchmark_display_name— nomes de exibição registrados para identificadores de benchmark.SOLVER_DISPLAY_NAMES/solver_display_name— nomes de exibição registrados para identificadores de solver.ABLATION_DISPLAY_NAMES/ablation_display_name— nomes de exibição para variantes de ablação de isolamento de mecanismo.benchmark_instance_label— um rótulo de exibição que mantém a identidade da instância visível.UnknownDisplayNameError— levantado quando um identificador não tem nome de exibição registrado.
Camadas de evidência:
Tier/tier/TIER_REGISTRY— as camadas de evidência públicas e onde a evidência de cada camada pode aparecer.UnknownTierError— levantado quando um identificador de camada não tem entrada no registro.
Tema de figuras:
FigureTheme/DEFAULT_THEME— cores, tipografia e largura de tela externamente controláveis e compartilhadas por toda família de gráficos.