Saltar al contenido
DispatchAtlas
Buscar

Referencia de la API

La API pública se agrupa por distribución. Importa desde el espacio de nombres más estrecho que posee el comportamiento. Las listas siguientes reflejan las exportaciones actuales del espacio de nombres público para que las personas lectoras puedan auditar la superficie de importación admitida sin leer los archivos __init__.py de cada paquete.

📦 Distribución raíz

Usa dispatchatlas.version para la superficie ligera de versión del paquete raíz:

  • __version__

🧱 Núcleo

dispatchatlas.core es el límite del paquete interno. Exporta objetos de dominio, validación, procedencia, serialización, semilla, sistema de archivos, registro y contratos de protocolo.

Contratos de configuración:

  • FoundationConfig
  • SeedPolicy
  • SerializationFormat
  • ValidationMode

Contratos de error:

  • DataQualityError
  • DispatchAtlasError
  • DomainValidationError
  • InfeasibleScheduleError
  • MissingOptionalDependencyError
  • ProvenanceError
  • ScheduleValidationError
  • SeedDerivationError
  • SerializationContractError
  • UnsupportedCapabilityError
  • require_finite — devuelve el valor convertido a un flotante finito o lanza el contrato de error indicado cuando es NaN o infinito.
  • require_non_negative_int — devuelve el entero o lanza el contrato de error indicado cuando es negativo.
  • require_positive_int — devuelve el entero o lanza el contrato de error indicado cuando no es positivo.
  • require_text — devuelve el texto recortado o lanza el contrato de error indicado cuando está en blanco.

Ayudantes del sistema de archivos:

  • 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

Observabilidad (registro centralizado):

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

Contratos de manifiesto de campaña:

  • 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

Contratos del modelo de planificación:

  • 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

Protocolos de integración:

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

Contratos de procedencia:

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

Contratos de semilla:

  • MAX_SEED
  • SEED_DOMAIN_SEPARATOR
  • Seed
  • SeedStream
  • derive_seed

Contratos de serialización:

  • 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

Contratos de validación:

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

Constantes de dimensionamiento del núcleo:

  • DEFAULT_CPU_RESERVE — CPUs reservadas del grupo de trabajadores de forma predeterminada.
  • DEFAULT_MEMORY_RESERVE_FRACTION — la fracción de memoria del sistema que se mantiene en reserva de forma predeterminada.
  • OBJECTIVE_FAMILY — el registro que asigna cada tipo de objetivo a su definición canónica.

Concurrencia del host:

  • available_cpu_count / available_system_memory_bytes — las CPUs disponibles para este proceso y la mejor estimación de memoria del sistema disponible.
  • maximal_safe_worker_count — el recuento máximo seguro de trabajadores paralelos para el host.

Modelo continuo (edge–fog–cloud):

  • ComputeTier — una capa de cómputo del continuo (edge, fog, cloud) con su capacidad agregada.
  • NetworkTopology / NetworkLink — la red de comunicación y sus enlaces dirigidos entre niveles.
  • Bandwidth / DataVolume — rendimiento positivo del enlace en bytes por segundo y datos transferibles no negativos en bytes.
  • PlacementAffinity — la preferencia de una tarea por un destino de colocación en el continuo.

Modelo de costo (R||Cmax, comunicación, ejecución dependiente de la carga, configuración dependiente de la secuencia):

  • CostModel / cost_model_from_jsonable / cost_model_to_jsonable — el paquete de modelo de costo vinculado a un problema por identificador, y su serialización.
  • ExecutionTimeMatrix / ExecutionTimeEntry / execution_matrix_from_iterable — la matriz de tiempos de ejecución de máquinas no relacionadas (p_ij).
  • CompatibilityMask — el conjunto explícito de elegibilidad tarea-a-máquina.
  • CommunicationModel / CommunicationLink — penalizaciones de comunicación entre recursos sobre un grafo disperso.
  • LoadModel / LoadModelKind / LoadBreakpoint — la curva de ejecución dependiente de la carga y su interpolación entre puntos de quiebre.
  • SetupMatrix / SetupEntry / SetupReferenceKind — tiempos de configuración dependientes de la secuencia indexados por transición y máquina.

Familia de objetivos:

  • ObjectiveKind / ObjectiveDefinition / objective_definition — objetivos de planificación con nombre y sus metadatos canónicos.
  • ObjectiveReduction / VectorObjectiveValue — la regla de escalarización y un vector multiobjetivo medido con metadatos de divulgación.
  • vector_objective_from_jsonable / vector_objective_to_jsonable — serialización del objetivo vectorial.

Evaluación de objetivos:

  • evaluate_objective / evaluate_objectives / ObjectiveEvaluation — evalúa uno o cada objetivo con nombre sobre una planificación.
  • MultiObjectiveOutcome / computed_vector / multi_objective_outcome_from_jsonable — objetivos escalares y vectoriales más la factibilidad para una planificación.
  • EvaluationStatus / objective_sense — si un valor fue calculado o diferido, y el sentido de optimización de un objetivo.

Factibilidad y restricciones:

  • FeasibilityReport / build_feasibility_report — filas de violaciones duras más la contabilidad de penalizaciones de restricciones blandas.
  • InfeasibleRow / SoftConstraintPenalty — una violación dura visible para la persona revisora y una penalización ponderada de restricción blanda.
  • ServiceLevelConstraint / ServiceLevelOutcome / evaluate_service_level / evaluate_service_level_over_schedule / resolve_metric — restricciones de nivel de servicio con nombre sobre una métrica de planificación y su evaluación.
  • ConstraintViolationSummary / summarize_constraints — contabilidad agregada de restricciones duras, blandas y de nivel de servicio.

Frente de Pareto e indicadores de calidad:

  • dominates / to_minimization — dominancia de Pareto bajo minimización y conversión de sentido mixto.
  • fast_non_dominated_sort / non_dominated_front / non_dominated_indices — ordenación no dominada NSGA-II y el conjunto no dominado.
  • FrontierPoint / LabelledPoint / frontier_data — vectores de objetivos etiquetados y registros listos para la frontera.
  • hypervolume / igd_plus / additive_epsilon_indicator / spread — los cuatro indicadores de calidad: hipervolumen, IGD+, epsilon aditivo y dispersión de vecino más cercano.
  • QualityIndicatorReport / quality_indicator_report — los cuatro indicadores para un frente frente a un conjunto de referencia.

Robustez:

  • PerturbationScenario / PerturbationSet — escenarios de perturbación con nombre para un objetivo.
  • RobustnessAggregation / RobustnessValue / evaluate_robustness — cómo un conjunto de perturbaciones se agrega en un número de robustez con su base declarada.

Manifiestos de ejecución:

  • RunTiming / ResourceUsage / SolverCounters — cronometraje de reloj de pared y en cualquier momento, uso máximo de recursos y contadores de esfuerzo del solucionador para una ejecución.
  • ConvergenceSample / TimedObjectiveSample — valores de objetivo observados en un recuento de iteraciones y en un desplazamiento de reloj de pared.

Terminación:

  • TerminationPolicy — una política de parada de solucionador componible y multicriterio.

Seguridad del sistema de archivos:

  • safe_path_under_root — una ruta devuelta solo cuando se resuelve por debajo de una raíz autorizada.

Serialización del continuo:

  • 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

🧪 Bancos de prueba

dispatchatlas.bench exporta catálogos de bancos de prueba, generadores de familias genéricas y del continuo, metadatos de generadores, materialización, validación de citas, caracterización, métricas de dureza y distancia de distribución, selección, descarga y contratos de taxonomía.

Contratos de catálogo:

  • 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

Contratos de caracterización:

  • CharacterizationMetrics
  • CharacterizationReport
  • characterize_problem

Contratos de citas:

  • CitationClaim
  • CitationMatrix
  • SourceKind
  • default_citation_matrix
  • validate_citation_matrix

Contratos de generador:

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

Contratos de materialización:

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

Contratos de metadatos:

  • BenchmarkConfig
  • DomainProfile
  • GeneratorMetadata
  • ScaleSpec

Contratos de familia genérica:

  • 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

Contratos de familia del continuo:

  • 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

Contratos de dureza:

  • 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

Contratos de distancia de distribución:

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

Contratos de selección:

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

Contratos de metadatos de catálogo y descarga:

  • 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

Contratos de taxonomía:

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

Contratos del registro de suites de referencia:

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

Contratos de mejor-solución-conocida:

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

Contratos de ingesta de instancias canónicas:

  • 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

🧮 Solucionadores

dispatchatlas.solve exporta metadatos de solucionadores, registros, líneas base constructivas, metaheurísticas, variantes NDSO, operadores, adaptadores opcionales y ayudantes de perfilado.

Contratos de línea base y ejecución:

  • DispatchRule
  • DispatchingSolver
  • OrderRunRequest
  • TerminationTracker — el evaluador con estado y de primero-en-disparar que pliega el progreso de un bucle de búsqueda en una TerminationPolicy y reporta qué criterio detuvo la ejecución.
  • baseline_solvers
  • neh_order — el orden de construcción-por-inserción NEH (Nawaz–Enscore–Ham).

Contratos de metadatos de solucionador:

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

Contratos de metaheurística:

  • MetaheuristicKind
  • PermutationMetaheuristicSolver
  • PermutationSearchConfig
  • metaheuristic_solvers

Contratos de planificación por listas basada en rangos:

  • ListSchedulingRank
  • ListSchedulingSolver
  • list_scheduling_solvers
  • heft_profile — planificación por listas de rango-ascendente (HEFT).
  • cpop_profile — planificación por listas de rango ascendente+descendente combinado (CPOP).
  • peft_profile — planificación por listas con tabla-de-coste-optimista (PEFT).

Contratos de reglas de mapeo sobre el conjunto-listo:

  • MappingRule
  • MappingRuleSolver
  • mapping_rule_profile
  • mapping_rule_solvers — las reglas por lotes min-min, max-min y sufferage.

Contratos de competidores multi-objetivo de Pareto:

  • NSGA2Config
  • NSGA2Solver
  • MOEADConfig
  • MOEADSolver
  • nsga2_profile
  • moead_profile
  • multi_objective_solvers
  • crowding_distances — el estimador de densidad por distancia-de-aglomeración de NSGA-II.
  • nsga2_environmental_selection — supervivencia elitista por rango-y-luego-aglomeración.
  • tchebycheff — la función escalarizante de Tchebycheff de MOEA/D.

Contratos de codicioso-iterado:

  • ITERATED_GREEDY_RS_CITATION
  • IteratedGreedyRSConfig
  • IteratedGreedyRSSolver — la configuración canónica de destrucción–construcción para flow shops de permutación.
  • iterated_greedy_rs_profile
  • iterated_greedy_rs_solvers

Contratos de tabú de ruta-crítica:

  • CriticalPathTabuConfig
  • CriticalPathTabuSolver
  • critical_path_tabu_profile
  • critical_path_tabu_solvers
  • critical_pairs — el generador de vecindad de pares-adyacentes de la ruta crítica.

Contratos de planificación de proyectos (SGS serial):

  • SerialSGSJustificationSolver — generación de planificación serial con doble justificación para la planificación de proyectos con recursos restringidos.
  • serial_sgs_justification_profile
  • serial_sgs_justification_solvers
  • double_justified_order — la pasada de justificación hacia-atrás–hacia-adelante.
  • latest_finish_order — el orden de prioridad por tiempo-de-fin-más-tardío.

Contratos NDSO:

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

Contratos de operadores de planificación:

  • 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

Contratos de adaptador opcional:

  • OptionalExactSolver
  • optional_solvers
  • ortools_dependency

Contratos de rendimiento:

  • BatchScoringProfile
  • ProfiledResult
  • profile_call

Contratos de registro:

  • ProfiledSolver
  • SolverRegistry
  • default_solver_registry

Constantes de ajuste del solucionador:

  • NATIVE_EXACT_TASK_CAP — el techo de recuento de tareas por encima del cual el solucionador exacto nativo falla de forma cerrada.
  • RUN_COUNT_FLOOR — el recuento mínimo de ejecuciones repetidas que requiere una comparación justa.
  • VELOCITY_WINDOW — la ventana de velocidad de mejora que observa el controlador de cualquier momento.
  • IMPROVEMENT_FLOOR — la mejora relativa mínima que cuenta como progreso.
  • FEATURE_ORIGIN — la métrica de la plataforma de bancos de prueba de la que deriva cada característica de selección.

Familias de despacho de línea base:

  • DispatchingFamilySpec — una familia de despacho con nombre vinculada a una regla de prioridad determinista.
  • RetiredFamily / RetirementReason / retired_dispatching_families — familias con nombre apartadas deliberadamente, cada una con su justificación.

Competidores diversificados (el campo metaheurístico con nombre):

  • CompetitorKind / CompetitorSolver / CompetitorConfig — competidores con nombre que comparten parámetros de búsqueda acotada.
  • competitor_solvers / diversified_competitors — el conjunto de competidores diversificado y consciente de la divulgación.
  • post_2020_currency_anchor — las referencias de anclaje de vigencia posteriores a 2020 para el campo.
  • recent_peer_strength_bar — los pares recientes retenidos bajo el listón de fortaleza de la sede.

Optimizadores continuos (decodificados sobre el orden discreto):

  • clpso_optimize / CLPSOConfig — optimización por enjambre de partículas con aprendizaje comprensivo.
  • lshade_optimize / LSHADEConfig — evolución diferencial adaptativa con historial de éxito y reducción lineal de población.
  • EncodedSolverKind / EncodedAdapterSolver / encoded_adapter_solvers — la familia continua vinculada a un adaptador de codificación discreta.
  • ContinuousResult / SearchBudget — el resultado de una ejecución continua y su presupuesto de iteraciones, aleatoriedad y reloj de pared.

Codificación de continuo a discreto:

  • EncodingAdapter / encoding_adapter / encoding_adapter_catalog — codificaciones continuo-a-discreto con nombre y reparación explícita.
  • DecodeRule / DecodeOutcome — la regla que convierte un vector de claves transformado en un orden de tareas, y su resultado reparado.
  • RepairPolicy — la política que restaura la factibilidad de precedencia tras la decodificación.
  • TransferFunction — la función de aplastamiento que mapea un componente continuo a una señal de selección.

Solucionadores exactos:

  • ExactMethod / ExactSolver — métodos exactos con nombre y un adaptador que falla de forma cerrada ante un backend ausente o una entrada de tamaño excesivo.
  • ExactAdapterSpec / exact_adapter_specs / exact_solvers — los contratos del adaptador de solucionador exacto empaquetado.

Competidor de muchos objetivos (NSGA-III):

  • NSGA3Solver / NSGA3Config / nsga3_solvers / nsga3_profile — el competidor NSGA-III sobre órdenes seguros respecto a la precedencia.
  • nsga3_reference_points — puntos de referencia estructurados Das & Dennis sobre el símplice unitario.
  • nsga3_environmental_selection — selección por nichos basada en puntos de referencia NSGA-III.

Variantes de planificación académicas:

  • SchedulingVariantKind / PermutationSchedulingVariantSolver / SchedulingVariantConfig — variantes híbridas académicas con nombre sobre la codificación de orden discreto.
  • scheduling_variant_solvers — las líneas base de variantes de planificación de primera clase.

Selección de algoritmos:

  • RuleBasedSelector — una línea base exclusiva de bancos de prueba que clasifica candidatos solo a partir de metadatos.
  • SupervisedSelector — un selector aprendido determinista de vecino más cercano ponderado por distancia.
  • SelectionFeature / SelectionFeatures / feature_origin — las características de caracterización con nombre que consume el selector y su origen.
  • SelectionLabel / SolverRecommendation / RecommendationSource — ejemplos de entrenamiento etiquetados y recomendaciones clasificadas con confianza y limitaciones.

Validación cruzada del selector (generalización libre de fugas):

  • cross_validate / GeneralizationReport — generalización de exclusión por familia (leave-one-family-out) sobre un corpus.
  • leave_one_family_out / partition_by_families / TrainTestSplit — divisiones de entrenamiento/prueba disjuntas por familia.
  • held_out_generalization — entrena con la mitad de entrenamiento de la división y reporta la precisión top-1 en su mitad de prueba.
  • leakage_report / LeakageReport — los solapamientos de instancia, familia y registro de caracterización que una división libre de fugas debe mantener vacíos.
  • validated_supervised_selector — un selector cuya confianza refleja su generalización fuera de muestra.

Interfaces de aprendizaje e híbridas (opcionales, de falla cerrada):

  • LearningInterfaceKind / LearningInterface / learning_interface / learning_interface_catalog — interfaces de aprendizaje e híbridas con nombre, con estado, política y respaldo.
  • InterfaceStatus / LearningEvidencePolicy — el estado del ciclo de vida y el contrato de evidencia que declara cada una de estas superficies.
  • ConfidenceLabel / confidence_rank — la confianza que puede llevar una recomendación y su fuerza ordinal.
  • learning_backend_available / learning_dependency / require_learning_backend — el backend de aprendizaje opcional (un extra, nunca un valor predeterminado) y su error de dependencia ausente tipado.

Metadatos de solucionador y citas:

  • Citation / CitationStatus — una referencia seminal canónica (o una justificación explícita de no aplicabilidad) y si una familia lleva una.
  • SolverEncoding — la codificación de solución sobre la que un solucionador busca o construye.
  • SUMMIT_EVIDENCE_LABEL — la etiqueta de contexto de divulgación para metadatos, evidencia y exportaciones.

Superficie de la familia NDSO:

  • NDSOFamilySolver — la superficie común de cada solucionador de la familia NDSO, ya sea de enjambre único o de consejo.
  • fast_mechanisms — el conjunto de mecanismos fijos de la composición rápida.

Mecanismos NDSO (construcción válida por diseño):

  • PrecedenceIndex / precedence_index — conjuntos de predecesores y un orden de tareas estable que usa cada constructor.
  • GuidanceSource / GuidanceContext / select_guidance — las tres fuentes de Triple-Guidance y las entradas de construcción compartidas de un candidato.
  • guided_construction — construir un candidato factible a partir de un orden de guía.
  • confidence_weighted_elite — forjar la Élite mediante votación ponderada por confianza.
  • ConfidenceMatrix / consolidate_confidence / latent_archive — la confianza aprendida por celda, su consolidación entre enjambres y las celdas confiables que la Élite ha abandonado.
  • quality_guidance / quantity_update / BetaSchedule — las reglas de calidad y cantidad y el coeficiente adaptativo unificado.
  • rank_reward — una recompensa derivada del rango en [0, 1].

Consejo entre enjambres NDSO:

  • NDSOSummitSolver / summit_solver / summit_profile / SummitConfig — el consejo entre enjambres, la composición de calidad de la familia.
  • CouncilTopology — la topología de intercambio entre enjambres que conecta los enjambres del consejo.
  • SummitDiagnostics — el resumen inmutable de coordinación del consejo adjunto a una ejecución.

Ablación de mecanismos NDSO:

  • AblationEntry / ablation_map — una ablación aislante por mecanismo canónico.
  • build_ablation_solver / run_ablation_suite / AblationRunResult — construir y ejecutar cada ablación aislante acotada por la factibilidad.
  • ABLATION_STATISTICAL_PLAN / StatisticalTestPlan — las pruebas estadísticas de la capa de análisis con nombre que usa una comparación de ablación.

Control de cualquier momento NDSO:

  • AnytimeController / AnytimeReport — el controlador de terminación temprana por velocidad de mejora y su registro de actividad.

Diagnósticos NDSO:

  • DiagnosticsCollector / DiagnosticsSnapshot — un registrador de convergencia opcional y de sobrecarga nula cuando está deshabilitado, y su resumen.
  • IterationTrace — el registro de convergencia de una iteración.
  • population_diversity — el desacuerdo medio de posición por pares en [0, 1].

Divulgación NDSO (compuerta de mecanismos de falla cerrada):

  • MechanismDescriptor / mechanism_descriptor / mechanism_catalog — mecanismos con nombre y el piso de divulgación al que pertenece cada uno.
  • DisclosureFilter / DisclosureViolationError — la compuerta de falla cerrada sobre qué mecanismos puede exponer un alcance de informe.
  • ReportScope / EvidenceProgram — alcances de informe por etapas y los cuatro programas de evidencia por etapas asignados a un piso de divulgación.
  • base_disclosure_filter / program_disclosure_filter — los filtros de falla cerrada de alcance base y por programa.
  • blocks_summit_evidence — si el filtro de un programa bloquea el piso de calidad exclusivo del consejo.

🚀 Campañas

dispatchatlas.lab exporta configuración de campaña reproducible, presupuesto, entorno, repositorio, fallo y contratos de ejecución.

Contratos de presupuesto:

  • CampaignBudgetReport
  • dry_run_campaign

Contratos de configuración:

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

Contratos de entorno:

  • capture_campaign_environment

Contratos de error:

  • BudgetEstimationError
  • CampaignConfigError
  • CampaignExecutionError
  • CheckpointRecoveryError
  • EnvironmentCaptureError

Contratos de repositorio:

  • CampaignResultIndex
  • CheckpointManifest
  • FailureRecord
  • FileResultRepository
  • RunRecord

Contratos del ejecutor:

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

Configuración de campaña:

  • CampaignKind — la clase de diseño experimental que realiza una campaña.
  • StoppingProtocol / StoppingProtocolKind — un protocolo de parada con nombre, reportable de forma independiente, para un informe de solucionador estocástico.
  • RunCountPolicy / STATISTICAL_POWER_FLOOR — la política de recuento de ejecuciones y el recuento mínimo de réplicas por debajo del cual las ejecuciones de un solucionador se marcan como de baja potencia.
  • TuningBudget — el presupuesto de ajuste por algoritmo igualitario que mantiene justa una comparación.
  • campaign_config_from_jsonable — rehidratar una configuración de campaña validada a partir de datos compatibles con JSON.

Resolución del recuento de ejecuciones:

  • ReplicateResolution / resolve_replicates — el recuento de réplicas resuelto para un solucionador, con cualquier marca de baja potencia, bajo la política de recuento de ejecuciones.

Invariante de comparación justa:

  • assert_fair_comparison — validar las precondiciones estructurales de la invariante de comparación justa.
  • fair_comparison_manifest — las filas de manifiesto que registran la garantía de comparación justa.

Configuración del motor (resolución de cuatro capas con sello de procedencia):

  • EngineSettings / resolve_engine_settings — los controles del motor resueltos a través de las cuatro capas de configuración, cada campo sellado con su procedencia.
  • ResolvedSetting / SettingSource — el valor de un ajuste emparejado con la capa que lo suministró.
  • apply_environment_overrides — superponer la capa de entorno sobre una configuración de campaña de archivo o de sitio de llamada.

Topología de trabajadores y agregación:

  • WorkerTopology / topology_for_plan / probe_capacity — la topología de trabajadores que respeta el presupuesto seleccionada para una campaña tras sondear la capacidad del host.
  • AggregateManifest / merge_only_aggregation — agregación determinista de solo fusión de registros de ejecución completados en un único hash de campaña estable a nivel de bits.

Atlas de experimentos:

  • ExperimentAtlas / default_experiment_atlas — un atlas consciente de la divulgación de pistas de evidencia propias.
  • EvidenceTrack — una porción de evidencia propia en el atlas de experimentos.

Matriz de aplicabilidad de familia-de-benchmark por solucionador:

  • ApplicabilityMatrix / default_applicability_matrix — la matriz completa de aplicabilidad de familia-de-benchmark por solucionador, derivada de los registros en vivo y luego anotada por la tabla de anulaciones.
  • ApplicabilityCell — una declaración de aplicabilidad (familia de benchmark, solucionador) que porta su estado, justificación y un puntero de evidencia opcional.
  • ApplicabilityStatus — el enum de estado por celda verificado / aproximado / no-aplicable.
  • ApplicabilityEvidence / ApplicabilityEvidenceKind — un puntero de evidencia seguro-para-el-portal (campaña, cita o prueba) y su clase de procedencia.
  • ApplicabilityOverride / default_applicability_overrides — una mejora manual revisable de una celda derivada, y la tabla de anulaciones en-código donde viven las celdas verificadas.
  • SchedulingFamilyCell — un resumen de familia-de-planificación por solucionador que agrega las celdas de familia-de-benchmark constituyentes.
  • derive_applicability_cell — deriva una celda aproximada-o-no-aplicable a partir de los metadatos declarados.
  • constraint_capability_bridge — el puente tipado de característica-de-restricción a etiqueta-de-capacidad (única fuente de verdad).
  • ApplicabilityScreen / screen_campaign_applicability — filtra el producto cruzado de una campaña planificada contra la matriz, reportando pares bloqueados, aproximados y verificados.

📊 Análisis

dispatchatlas.analytica exporta filtrado de divulgación, ingesta, resúmenes estadísticos, escritores deterministas de tablas Markdown, dieciséis familias de gráficos cada una renderizada en formato dual (SVG temable y PGFPlots .tex editable), paquetes de evidencia y conjuntos de datos del portal.

Contratos de divulgación:

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

Contratos de exportación:

  • ExportBundle
  • evidence_bundle_directory
  • write_evidence_bundle
  • write_portal_dataset

Contratos de ingesta:

  • PlanRunFacts
  • load_campaign_dataset
  • load_result_dataset

Contratos de modelo:

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

Contratos estadísticos:

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

Contratos de tabla:

  • 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

Contratos de visualización (cada familia de gráficos se renderiza como SVG temable y PGFPlots .tex editable):

  • 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

Contratos de comparación:

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

Inferencia y tamaños de efecto (pruebas de significancia deterministas y sin dependencias):

  • friedman_test / FriedmanResult — prueba ómnibus de rangos de Friedman sobre múltiples algoritmos.
  • FriedmanOutcome — prueba ómnibus de rangos de Friedman sobre el campo completo de solucionadores.
  • nemenyi_critical_difference / CriticalDifference — diferencia crítica de Nemenyi de todos los pares para rangos medios.
  • wilcoxon_signed_rank / WilcoxonResult — prueba de rangos con signo de Wilcoxon bilateral para diferencias emparejadas.
  • bayesian_sign_test / BayesianSignTestResult — prueba bayesiana de signo con una región de equivalencia práctica sobre diferencias emparejadas.
  • bayesian_signed_rank_test / BayesianSignedRankResult — prueba bayesiana de rangos con signo de proceso de Dirichlet sembrada con una región de equivalencia práctica sobre diferencias emparejadas.
  • vargha_delaney_a12 / interpret_a12 — tamaño de efecto A12 de Vargha-Delaney y su etiqueta de magnitud.
  • bca_bootstrap_interval / BootstrapInterval — intervalo de confianza bootstrap corregido por sesgo y acelerado.
  • standard_normal_cdf / standard_normal_ppf — distribución acumulada normal estándar y cuantil.
  • chi_square_sf — probabilidad de cola superior (supervivencia) chi-cuadrado.
  • detectable_effect_size / required_paired_count / PowerAssessment — el menor efecto emparejado estandarizado detectable a un número de ejecuciones, y su inverso.
  • ArpdRow / arpd_rows — desviación porcentual relativa promedio por solucionador frente a valores de referencia mejor-conocidos suministrados por quien llama con procedencia explícita.
  • ensure_equal_budgets — verificación de falla cerrada del protocolo de presupuesto-igual escalado-con-el-tamaño.

Registro de métodos de análisis (selección de métodos de falla cerrada):

  • AnalysisMethod / method_registry / method_by_id — métodos con nombre con sus supuestos y pisos de divulgación.
  • AnalysisFamily / methods_in_family — familias de métodos y su pertenencia.
  • MethodSupport / evaluate_support — el veredicto de soporte de falla cerrada para un método sobre un tamaño de muestra dado.
  • MethodLimitation — un método con nombre no soportado encaminado a la superficie de limitaciones.
  • STATISTICAL_POWER_FLOOR — el tamaño de muestra mínimo por debajo del cual los métodos de baja potencia fallan de forma cerrada.

Marcos de análisis (marcos auxiliares de filas y series que renderiza un consumidor de figuras o tablas):

  • AnalysisFrames — el paquete de marcos auxiliares para un conjunto de datos.
  • BenchmarkRow / benchmark_rows — cobertura por instancia de banco de prueba en el campo de solucionadores.
  • CharacterizationRow / characterization_rows — descriptores de dificultad por problema a partir de la dispersión observada.
  • ConstraintRow — una fila de contabilidad de restricciones sobre el conjunto de datos.
  • ConvergenceSeries / convergence_series — trazas de mejor-objetivo por solucionador según la iteración.
  • DataProfileSeries / data_profile_series — fracción de celdas resueltas por solucionador a una precisión objetivo dentro de un presupuesto de grupos-de-evaluación para la figura de perfil-de-datos.
  • DiversitySeries / diversity_series — trazas de diversidad de población por solucionador según la iteración para la figura de balance exploración-explotación.
  • InfeasibleRunRow / infeasible_rows — ejecuciones completadas infactibles y fallos registrados encaminados a los suplementos.
  • OptimalityGapRow / optimality_gap_rows — brechas de optimalidad por (problema, solucionador) frente a cotas de referencia.
  • RobustnessPoint / robustness_points — CVaR por solucionador + riesgo de cola del peor caso sobre el conjunto de objetivos para la figura de robustez.
  • RuntimeQualityPoint / runtime_quality_points — observaciones de tiempo-calidad para la figura de tiempo-calidad.
  • ScalabilitySeries / scalability_series — trazas de tiempo-medio-por-escala-de-instancia por solucionador para la figura de escalabilidad.
  • SensitivityPoint — una media a nivel de parámetro para un barrido de sensibilidad.
  • StabilityPoint / stability_points — estabilidad por semilla por solucionador (coeficiente de variación medio) para la figura de estabilidad.
  • AblationRow — un resultado de aislamiento de mecanismo frente a la configuración completa.

Indicadores multiobjetivo:

  • MultiObjectiveIndicatorRow / multiobjective_indicators — los cuatro indicadores de calidad con nombre por frente de aproximación de cada solucionador.
  • MultiObjectiveIndicatorReport / multiobjective_indicator_report — filas de indicadores junto al punto de referencia compartido archivado que las produjo.
  • ReferencePointRule / ReferencePointRecord — las reglas de derivación del punto de referencia y el registro archivado con su vocabulario de procedencia de falla cerrada.
  • ensure_shared_reference_points — comprobación de falla cerrada de que los artefactos comparados comparten un único punto de referencia archivado.
  • quality_indicator_method_ids — los identificadores de métodos del registro que esta superficie calcula de principio a fin.

Comparación de plataformas (evidencia de capacidad y distancia de distribución):

  • PlatformComparison / platform_comparison_markdown — los cuatro conjuntos de filas de comparación de plataformas y su Markdown.
  • RivalFrameworkRow / rival_framework_markdown — comparación de capacidades frente a un framework rival.
  • FeatureRichnessRow / feature_richness_markdown — la matriz de cobertura de características.
  • DistributionDistanceRow / distribution_distance_markdown — la evaluación del puente de distancia de distribución por familia de bancos de prueba.
  • ArtifactInspectionRow / artifact_inspection_markdown — la evidencia de inspección de artefactos del portal.
  • EvidenceSource — cómo se respalda la afirmación de una fila de comparación de plataformas.

Andamiaje de informes, compuertas de afirmaciones y redacción:

  • ReportScaffold / ReportScaffoldSpec / ReportProfile / ReportSection / CANONICAL_SECTION_ORDER / write_report_scaffold — andamiajes de informes deterministas, enlazados a la fuente y filtrados por divulgación.
  • ClaimGate / ClaimGateKind / ClaimGateState / ClaimGateOutcome / evaluate_claim_gate — afirmaciones de informe condicionadas por la evidencia y sus veredictos de promoción.
  • ContributionMatrix / ContributionRow / ContributionOverlap / contribution_partition — una partición de contribuciones sin solapamiento entre niveles de evidencia.
  • RedactionFinding / redaction_report / assert_redaction_clean — escanear una candidata superficie pública en busca de términos prohibidos y fugas entre niveles.
  • ReproducibilityBadge — un objetivo de insignia de reproducibilidad y cómo el índice de artefactos lo satisface.
  • MaintenanceLedgerEntry / maintenance_ledger_markdown — superficies de extensión futura que no deben debilitar el límite de divulgación.

Manifiesto de reproducibilidad:

  • ReproducibilityManifest / build_reproducibility_manifest / reproducibility_manifest_markdown — los hechos de reproducibilidad por ejecución y su documento Markdown.
  • FIGURE_GENERATORS — el registro de generadores de figuras que registra el manifiesto.

Glosario de solucionadores (superficie de nomenclatura sin metáforas):

  • SOLVER_OPERATIONAL_DESCRIPTIONS / solver_operational_description — la descripción operativa sin metáforas por solucionador.
  • SOLVER_EQUIVALENCE_NOTES / solver_equivalence_note — la nota de equivalencia con algoritmo conocido por solucionador.
  • INSPIRATION_DOMAIN_TERMS / metaphor_terms_in — el inventario de términos del dominio de inspiración y su detección.

Registros de nombres de visualización:

  • BENCHMARK_DISPLAY_NAMES / benchmark_display_name — nombres de visualización registrados para identificadores de bancos de prueba.
  • SOLVER_DISPLAY_NAMES / solver_display_name — nombres de visualización registrados para identificadores de solucionadores.
  • ABLATION_DISPLAY_NAMES / ablation_display_name — nombres de visualización para variantes de ablación de aislamiento de mecanismos.
  • benchmark_instance_label — una etiqueta de visualización que mantiene visible la identidad de la instancia.
  • UnknownDisplayNameError — lanzado cuando un identificador no tiene nombre de visualización registrado.

Niveles de evidencia:

  • Tier / tier / TIER_REGISTRY — los niveles de evidencia públicos y dónde puede aparecer la evidencia de cada nivel.
  • UnknownTierError — lanzado cuando un identificador de nivel no tiene entrada en el registro.

Tema de figuras:

  • FigureTheme / DEFAULT_THEME — colores, tipografía y ancho de lienzo controlables externamente y compartidos por cada familia de gráficos.