admin/AFRYCA
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
08747099b0108ec4776b1c413ab50083112bb0cb
AFRYCA/README.md
T
admin b8141736eb public code v1
2026-05-22 11:14:29 +02:00

18 KiB
Raw Blame History

AFRYCA — Analytical Framework for Group Decision-Making

AFRYCA es una plataforma de software científico basada en Eclipse RCP para el análisis de problemas de toma de decisiones en grupo (GDM - Group Decision Making). Permite modelar, simular y analizar procesos de consenso con múltiples expertos, incorporando más de 20 modelos de consenso publicados en literatura científica.

Tabla de Contenidos

Descripción General

AFRYCA es una aplicación de escritorio (Rich Client Platform) desarrollada sobre Eclipse E4 que proporciona un entorno integrado para:

  • Definir problemas de decisión en grupo (GDMP) con múltiples expertos, alternativas y criterios.
  • Aplicar modelos de consenso basados en publicaciones científicas para simular procesos de negociación.
  • Ejecutar scripts analíticos en múltiples lenguajes de programación (Python, Groovy, Ruby, Scala, Lua, R) a través del motor ASE.
  • Visualizar resultados mediante gráficos y matrices de decisión interactivos.
  • Modelar comportamientos de expertos (actitudes estándar y adversas) durante el proceso de consenso.

La plataforma está orientada a investigadores y académicos en el área de inteligencia computacional y toma de decisiones difusas.

Características Principales

Problemas de Decisión en Grupo (GDMP)

  • Definición de problemas con múltiples expertos, alternativas y criterios
  • Gestión de dominios de datos: números reales, enteros y conjuntos difusos
  • Soporte para relaciones de preferencia de distintos tipos
  • Workspace con ejemplos precargados (CAEPIA2016, Palomares2014)

Modelos de Consenso (20+)

  • Implementaciones directas de modelos publicados en literatura científica
  • Más de 20 modelos distintos cubriendo desde 2008 hasta 2020
  • Soporte para variantes con clustering, workflow y ELICIT

Motor de Scripting Analítico (ASE)

  • Ejecución de scripts en 6 lenguajes: Jython, Groovy, JRuby, Scala, LuaJ y R
  • Sistema modular de fragmentos, funciones y módulos reutilizables
  • Consola interactiva integrada

Simulación

  • Simulación de rondas de negociación y convergencia al consenso
  • Modelado de actitudes y comportamientos de expertos
  • Generación de estadísticas y reportes detallados

Visualización

  • Matrices de decisión interactivas
  • Gráficos con JFreeChart y SWTChart
  • Vistas de análisis de preferencias
  • Soporte de gráficos 3D mediante JOGL

Tecnologías y Dependencias

Lenguajes de Programación

Lenguaje Uso
Java 8 / 11 Lenguaje principal del proyecto
Groovy Motor de scripting embebido
Jython (Python) Motor de scripting embebido
JRuby (Ruby) Motor de scripting embebido
Scala Motor de scripting embebido
Lua (LuaJ) Motor de scripting embebido
R Motor de scripting embebido

Framework y Plataforma

Tecnología Versión Propósito
Eclipse RCP E4 Photon Plataforma Rich Client
OSGi - Arquitectura modular de plugins
Eclipse Tycho 2.0.0 Build Maven para Eclipse RCP
EMF - Eclipse Modeling Framework

Librerías de UI y Gráficos

Librería Propósito
SWT Standard Widget Toolkit (GUI nativa)
JFace Componentes avanzados y databinding
SWTChart Gráficos integrados en SWT
JFreeChart Reportes y gráficos estadísticos
JOGL Gráficos 3D con OpenGL
KTable Componentes de tabla personalizados

Librerías Científicas

Librería Propósito
Apache Commons Math 3 Cálculos matemáticos avanzados
Apache Commons IO Utilidades de entrada/salida

Herramientas de Construcción

  • Apache Maven 3.x con extensión Tycho PomLess
  • Scripts de build para Windows (build.bat, clean.bat)

Arquitectura del Proyecto

El proyecto sigue una arquitectura en capas sobre OSGi/Eclipse E4:

┌──────────────────────────────────────────────────────────────┐
│                    CAPA DE PRESENTACIÓN (UI)                  │
│   afryca.rcp  ·  afryca.*.gui  ·  afryca.workspace.gui       │
│   afryca.structure.gui  ·  afryca.decisionmatrix.gui          │
└───────────────────────────┬──────────────────────────────────┘
                            │
┌───────────────────────────▼──────────────────────────────────┐
│                   CAPA DE LÓGICA DE NEGOCIO                   │
│  afryca.consensusmodel (20+ modelos)  ·  afryca.gdmp          │
│  afryca.behavior  ·  afryca.simulation  ·  afryca.ase         │
└───────────────────────────┬──────────────────────────────────┘
                            │
┌───────────────────────────▼──────────────────────────────────┐
│                    CAPA DE DATOS / DOMINIO                    │
│  afryca.domain*  ·  afryca.pr  ·  afryca.cm  ·  afryca.hpr   │
│  afryca.lpr  ·  afryca.mpr  ·  afryca.fpr  ·  afryca.hlpr    │
│  afryca.structure  ·  afryca.twotuple  ·  afryca.elicit       │
└───────────────────────────┬──────────────────────────────────┘
                            │
┌───────────────────────────▼──────────────────────────────────┐
│               LIBRERÍAS EXTERNAS / PLATAFORMA                 │
│  Eclipse RCP/E4  ·  EMF  ·  Apache Commons  ·  JFreeChart    │
│  SWT/JFace  ·  Jython  ·  Groovy  ·  JRuby  ·  Scala  ·  R  │
└──────────────────────────────────────────────────────────────┘

Patrones Arquitectónicos Utilizados

  • OSGi Plugin Architecture: Modularidad y extensibilidad mediante bundles
  • E4 Dependency Injection: Inyección de dependencias nativa de Eclipse E4
  • Strategy Pattern: Múltiples implementaciones de modelos de consenso
  • Factory Pattern: Creadores de estructuras y conversores de parámetros
  • MVVM: En componentes GUI con JFace databinding
  • Service-Oriented: Servicios OSGi registrados mediante ContextFunction

Requisitos del Sistema

Para ejecutar AFRYCA

  • Java Runtime Environment: JRE 8 o superior
  • Sistema Operativo compatible:
    • Windows (32/64 bits)
    • Linux GTK (32/64 bits)
    • macOS Cocoa (64 bits)
  • Memoria RAM: 512 MB mínimo recomendado
  • Espacio en disco: ~200 MB para la instalación completa

Para construir AFRYCA desde código fuente

  • Java Development Kit: JDK 8 o JDK 11
  • Apache Maven: 3.6.x o superior
  • Eclipse IDE con PDE (Plugin Development Environment) — opcional, para desarrollo

Instalación y Construcción

Construcción desde código fuente

En Windows:

# Construcción completa
build.bat

# Limpieza y verificación
clean.bat

Mediante Maven directamente:

# Construcción completa
mvn clean install

# Solo empaquetado
mvn clean package

# Limpieza
mvn clean

Plataformas de construcción configuradas

Sistema Operativo Arquitectura Estado
Linux GTK x86 Soportado
Linux GTK x86_64 Soportado
Windows win32 x86 Soportado
Windows win32 x86_64 Soportado
macOS Cocoa x86_64 Soportado

Los artefactos de construcción se generan en releng/afryca.application.product/target/.

Estructura del Proyecto

afryca-master/
├── plugins/                    # Plugins OSGi del proyecto (91 total)
│   ├── afryca.*/               # 78 plugins propios de AFRYCA
│   ├── com.jogamp.jogl/        # Librería JOGL (OpenGL)
│   ├── de.kupzog.ktable/       # Widget KTable
│   ├── Jython/                 # Intérprete Python (Jython)
│   ├── org.apache.commons.math3/  # Apache Commons Math
│   ├── org.codehaus.groovy/    # Groovy
│   ├── org.jfree.chart.JFreeChart/ # JFreeChart
│   ├── org.jruby/              # JRuby (Ruby)
│   ├── org.luaj/               # LuaJ (Lua)
│   └── org.swtchart*/          # SWT Chart
│
├── features/                   # Features Eclipse (43 total)
│   └── afryca.*.feature/       # Agrupaciones de plugins
│
├── releng/                     # Release Engineering
│   ├── afryca.application.configuration/  # Configuración del build
│   ├── afryca.application.product/        # Definición del producto
│   └── afryca.application.update/         # Repositorio P2
│
├── design/                     # Assets de diseño
│   ├── logo/                   # Logos PNG y SVG
│   └── workspace/              # Recursos del workspace
│
├── theme/                      # Temas visuales
│   ├── 2.0 - Burundi/          # Tema versión 2.0
│   └── 3.0 - Cameroon/         # Tema versión 3.0 (actual)
│
├── workspace/                  # Workspace Eclipse de trabajo
├── pom.xml                     # POM raíz Maven
├── build.bat                   # Script de construcción (Windows)
└── clean.bat                   # Script de limpieza (Windows)

Módulos y Plugins

1. Core de la Aplicación

Plugin Descripción
afryca.rcp Aplicación RCP principal, lifecycle manager
afryca.workspace Gestión de ficheros y workspace
afryca.theme Tema visual CSS de la aplicación

2. Modelos de Datos y Dominio

Plugin Descripción
afryca.domain Dominio base abstracto
afryca.domain.real Dominio de números reales
afryca.domain.integer Dominio de números enteros
afryca.domain.fuzzyset Dominio de conjuntos difusos
afryca.structure Estructuras base del modelo
afryca.cm Consensus Matrix
afryca.twotuple Representación Two-Tuple
afryca.decisionmatrix Matrices de decisión

3. Relaciones de Preferencia

Plugin Descripción
afryca.pr Preference Relation (base)
afryca.hpr Hesitant Preference Relations
afryca.lpr Linguistic Preference Relations
afryca.mpr Multiplicative Preference Relations
afryca.fpr Fuzzy Preference Relations
afryca.hlpr Hesitant Linguistic Preference Relations
afryca.elicit Operaciones ELICIT

4. Lógica Principal de Decisión

Plugin Descripción
afryca.gdmp Group Decision-Making Problem (núcleo)
afryca.consensusmodel Base para todos los modelos de consenso
afryca.behavior Modelos de comportamiento de expertos
afryca.behavior.standard Comportamiento estándar
afryca.behavior.standard_with_adverse Comportamiento con actitud adversa
afryca.simulation Motor de simulación
afryca.valueforcer Forzadores de valores
afryca.parametervalueconverterhelper Conversores de parámetros

5. Motor de Scripting (ASE)

Plugin Descripción
afryca.ase Analytical Scripting Engine (núcleo)
afryca.ase.engine.Jython Motor Python
afryca.ase.engine.Groovy Motor Groovy
afryca.ase.engine.JRuby Motor Ruby
afryca.ase.engine.Scala Motor Scala
afryca.ase.engine.LuaJ Motor Lua
afryca.ase.engine.R Motor R
afryca.ase.gui Interfaz gráfica del ASE
afryca.rcp.ase.context Contexto ASE para la aplicación

6. Interfaces Gráficas (GUI)

Plugin Descripción
afryca.workspace.gui GUI del workspace
afryca.gdmp.gui GUI de problemas de decisión
afryca.consensusmodel.gui GUI de modelos de consenso
afryca.simulation.gui GUI de simulación
afryca.structure.gui GUI de estructuras
afryca.decisionmatrix.gui GUI de matrices de decisión
afryca.domain.*.gui GUIs de dominios de datos
afryca.behavior.*.gui GUIs de comportamientos
afryca.*.gui GUIs para cada módulo principal

Modelos de Consenso Implementados

AFRYCA incluye implementaciones de los siguientes modelos de consenso publicados en literatura científica:

Plugin Referencia
afryca.consensusmodel.Chiclana2008 Chiclana et al. (2008)
afryca.consensusmodel.HerreraViedma2002 Herrera-Viedma et al. (2002)
afryca.consensusmodel.Kacprzyk2010 Kacprzyk et al. (2010)
afryca.consensusmodel.Palomares2014 Palomares et al. (2014)
afryca.consensusmodel.Palomares2014_clustering Palomares et al. (2014) — variante clustering
afryca.consensusmodel.Palomares2014_workflow Palomares et al. (2014) — variante workflow
afryca.consensusmodel.Labella2019 Labella et al. (2019)
afryca.consensusmodel.Labella2020 Labella et al. (2020)
afryca.consensusmodel.Labella2020ELICIT Labella et al. (2020) — variante ELICIT
afryca.consensusmodel.Rodriguez2015 Rodríguez et al. (2015)
afryca.consensusmodel.Rodriguez2018 Rodríguez et al. (2018)
afryca.consensusmodel.Rodriguez2018_clustering Rodríguez et al. (2018) — variante clustering
afryca.consensusmodel.Wu2012 Wu et al. (2012)
afryca.consensusmodel.Xu2013 Xu et al. (2013)
afryca.consensusmodel.Zhang2011 Zhang et al. (2011)
afryca.consensusmodel.Zhang2012 Zhang et al. (2012)
afryca.consensusmodel.Quesada2015 Quesada et al. (2015)
afryca.consensusmodel.HongBin2018 Hong & Bin (2018)
afryca.consensusmodel.Ishizaka2018 Ishizaka et al. (2018)
afryca.consensusmodel.TransRisk2018 TransRisk (2018)
afryca.consensusmodel.Fen2015 Fen et al. (2015)

Motor de Scripting (ASE)

El Analytical Scripting Engine (ASE) permite a los investigadores ejecutar scripts de análisis directamente dentro de AFRYCA en múltiples lenguajes de programación.

Lenguajes Soportados

  • Jython — Python 2.x embebido en Java
  • Groovy — Lenguaje dinámico basado en JVM
  • JRuby — Ruby embebido en Java
  • Scala — Lenguaje funcional/OOP en JVM
  • LuaJ — Lua embebido en Java
  • R — Lenguaje estadístico

Componentes del ASE

  • Fragmentos (Fragments): Porciones de código reutilizables
  • Funciones (Functions): Funciones definidas por el usuario
  • Módulos (Modules): Agrupaciones de funciones y lógica
  • Snippets: Ejemplos y plantillas de código precargados

El workspace incluye un repositorio de snippets y ejemplos precargados para todos los motores disponibles.

Representaciones de Preferencia

AFRYCA soporta múltiples formas de expresar preferencias entre alternativas:

Tipo Nombre Completo Descripción
PR Preference Relation Relación de preferencia base
HPR Hesitant Preference Relations Preferencias con hesitación
LPR Linguistic Preference Relations Preferencias lingüísticas
MPR Multiplicative Preference Relations Preferencias multiplicativas
FPR Fuzzy Preference Relations Preferencias difusas
HLPR Hesitant Linguistic Preference Relations Preferencias lingüísticas hesitantes

Dominios de Datos

Dominio Descripción
Real Valores en el intervalo [0, 1] o rangos personalizados
Integer Escalas enteras (ej. 1-9)
FuzzySet Conjuntos difusos triangulares/trapezoidales
Two-Tuple Representación two-tuple lingüística

Configuración de la Aplicación

Información del Producto

  • Nombre: AFRYCA
  • Versión: 3.0 (Cameroon)
  • Plataforma base: Eclipse E4 Application
  • Tema visual: afryca.theme (CSS)
  • Lifecycle Manager: afryca.rcp.lifecycle.LifeCycleManager

Temas Disponibles

Versión Nombre
2.0 Burundi
3.0 Cameroon (actual)

Configuración de Build (Tycho)

<tycho.version>2.0.0</tycho.version>
<project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
<maven.compiler.source>1.8</maven.compiler.source>
<maven.compiler.target>1.8</maven.compiler.target>

Ejemplos Precargados en el Workspace

  • CAEPIA2016 — Ejemplo de congreso CAEPIA 2016
  • Palomares2014_HR — Recursos Humanos
  • Palomares2014_Marketing — Marketing
  • Palomares2014_Sales — Ventas
  • Palomares2014_Technical — Técnico

Estadísticas del Proyecto

Métrica Valor
Total de plugins OSGi 91
Plugins propios (afryca.*) 78
Features Eclipse 43
Ficheros Java ~863
Modelos de consenso 20+
Motores de scripting 6
Tipos de PR soportados 6

Licencia

Este proyecto es software académico/de investigación. Consultar los términos de licencia específicos en cada plugin. Las dependencias externas incluidas mantienen sus propias licencias:

  • JOGL: New BSD License
  • Apache Commons: Apache License 2.0
  • JFreeChart: GNU LGPL
  • Groovy: Apache License 2.0
  • JRuby: CPL/GPL/LGPL (triplicado)
  • LuaJ: MIT License
  • Jython: Python Software Foundation License
Reference in New Issue View Git Blame Copy Permalink