Inicio Rápido

Introducción

HRDS es un simulador que permite visualizar y analizar cómo se distribuyen los recursos en una población bajo diferentes escenarios y condiciones.

Comenzando

1. Selección de Escenario

Escoja uno de los 6 escenarios disponibles en la matriz
Cada escenario representa diferentes ratios H:R y comportamientos MAX
Los escenarios van desde abundancia natural hasta escasez inducida

2. Configuración

Ajuste el número de humanos (H)
Ajuste el número de recursos (R)
Active/desactive el comportamiento maximizador (MAX)

3. Fases de Simulación

Fase 1: Asignación

Los humanos capturan recursos cercanos
Con MAX ON pueden capturar múltiples recursos
Con MAX OFF solo capturan un recurso

Fase 2: Asociación

Se forman estructuras sociales
Se visualizan conexiones entre grupos
Se calculan métricas de desigualdad

4. Análisis de Resultados

Revise el coeficiente Gini
Examine la distribución por clases sociales
Analice los gráficos de distribución
Exporte o imprima el informe

Flujo del Programa

Diagramas de Flujo

1. Inicialización

graph TD; A[Inicio] --> B[Selección Escenario] B --> C[Config Parámetros] C --> D[Init Canvas] D --> E[Crear Entidades] E --> F[Inicio Simulación]

2. Fase de Asignación

graph TD; A[Inicio] --> B[Distribución] B --> C{MAX?} C -->|ON| D[Captura Múltiple] C -->|OFF| E[Captura Única] D --> F[Clases] E --> F F --> G[Fin]

3. Fase de Asociación

graph TD; A[Inicio Fase 2] --> B[Ocultar Recursos] B --> C[Cálculo Conexiones] C --> D[Formar Estructuras] D --> E[Mostrar Enlaces] E --> F[Fin Fase 2]

4. Análisis y Reportes

graph TD; A[Datos] --> B[Métricas] B --> C[Gráficos] C --> D[Informe] D --> E[Visualización]

Documentación Técnica

Arquitectura del Sistema

Componentes Principales

Core

Simulation.js: Motor principal de simulación
Entity.js: Gestión de entidades
Canvas.js: Renderizado y visualización
StatsDisplay.js: Visualización de estadísticas

Modelos

DefaultModel.js: Implementación del modelo base
Lógica de comportamiento y reglas de simulación

Utilidades

EventEmitter.js: Sistema de eventos personalizado
MatrixController.js: Gestión de escenarios

API Interna

class Simulation {
  constructor(model)
  initialize(humanCount, resourceCount)
  start()
  stop()
  reset()
  nextRound()
  getEntitiesByType(type)
}

class Entity {
  constructor(x, y, type, size)
  move(canvas)
  draw(ctx)
  flash()
}

class DefaultModel {
  constructor()
  setMaximizerBehavior(isMaximizer)
  applyInitialRules(simulation)
  applyRules(simulation)
  calculateSocialClasses(simulation)
}

Fundamentos Teóricos

Distribución de Recursos

Coeficiente de Gini

Medida de desigualdad
Rango de 0 (igualdad perfecta) a 1 (desigualdad máxima)
Aplicado a la distribución de recursos

Comportamiento Maximizador

Basado en teoría económica clásica
Agentes buscan maximizar beneficios
Impacto en la distribución de recursos

Estructuras Sociales

Formación de clases sociales
Redes de conexión y jerarquías
Movilidad social y barreras

Escenarios de Distribución

Abundancia vs Escasez
Natural vs Inducido
Equilibrio y desequilibrio