tamarin

Tamarin is an open-source interactive alternative ranking system for Multi-Criteria Decision-Making (MCDM) designed to help users select the optimal technology alternatives based on their preferences and criteria.

https://github.com/dhmmasson/tamarin

Science Score: 67.0%

This score indicates how likely this project is to be science-related based on various indicators:

  • CITATION.cff file
    Found CITATION.cff file
  • codemeta.json file
    Found codemeta.json file
  • .zenodo.json file
    Found .zenodo.json file
  • DOI references
    Found 9 DOI reference(s) in README
  • Academic publication links
    Links to: zenodo.org
  • Academic email domains
  • Institutional organization owner
  • JOSS paper metadata
  • Scientific vocabulary similarity
    Low similarity (15.2%) to scientific vocabulary

Keywords

decision-making decision-making-algorithm interactive-visualizations user-interface
Last synced: 7 months ago · JSON representation ·

Repository

Tamarin is an open-source interactive alternative ranking system for Multi-Criteria Decision-Making (MCDM) designed to help users select the optimal technology alternatives based on their preferences and criteria.

Basic Info
Statistics
  • Stars: 2
  • Watchers: 1
  • Forks: 1
  • Open Issues: 4
  • Releases: 3
Topics
decision-making decision-making-algorithm interactive-visualizations user-interface
Created about 6 years ago · Last pushed over 1 year ago
Metadata Files
Readme License Citation Codeowners

README.md

Tamarin

SWH DOI License: MIT

Tamarin is an open-source interactive alternative ranking system for Multi-Criteria Decision-Making (MCDM) designed to help users select the optimal technology alternatives based on their preferences and criteria. The software integrates quantitative and qualitative data to rank alternatives, considering user-defined importance and uncertainty levels. Tamarin’s dynamic user interface allows real-time adjustments, enabling users to set for each criteria, importance, and granularity, and observe the impact on rankings. Built for flexibility, Tamarin supports various decision-making scenarios, including refurbishment technology selection, washing machine comparisons, or any decision involving evaluated alternatives provided through CSV files.

You can observe not only the ranking but also the impact of each parameter on the final ranking but on each individual criteria with the parallel plot visualisation:

Demonstration of the parallel plot

Install

Generate the static version

For version 2.0 the idea is to generate a static version of the application that can be served by any web server. This mean rendering the pug into HTML, rendering the scss to css and bundling the app logic into a single js file. The "api" part is statically generated, (the JSON files are directly served as files). Version 2 will drop all the app logic, and will rely on the csv import for the orignal dataset.

To build the full project: bash npm run build you can build indivually the css, pug or js elements. build-css sass public/stylesheets/style.scss docs/static/stylesheets/style.css --quiet build-pug npx pug3 -P views/index.pug --out docs/static/ build-template node src/exportTemplate.cjs build-js npm run build-template && webpack --config webpack.config.cjs --mode=production build npm run build-css && npm run build-pug && npm run build-js

node version (DEPRECATED)

  1. Create the database and populate the database
    1. Create an empty database on mysql
    2. Import db/structure_*.sql ( you may have to reorder the elements )
    3. import dataset db/dataset.sql
  2. rename .env.exemple .env and modify .env file with database information (host, name, user, password)
  3. install libraries : npm install
  4. test by launching the app : npm start

quick dev

  1. install nodemon : npm install nodemon
  2. launch the app :
  • nodemon ./bin/www.mjs
  • Or a better version :
  • nodemon -i public/javascripts -e js,pug,mjs,cjs bin/www.mjs

Cite

Latest version

APA Masson, D., Laguna Salvadó, L., & Villeneuve, E. (2024). Tamarin [Computer software]. https://doi.org/10.5281/zenodo.13628637

bibtex @software{Masson_Tamarin_2024, author = {Masson, Dimitri and Laguna Salvadó, Laura and Villeneuve, Eric}, license = {MIT}, month = sep, title = {{Tamarin}}, url = {https://github.com/dhmmasson/tamarin}, version = {v1.9}, year = {2024} doi = {10.5281/zenodo.13628637} }

version v1.9

APA Masson, D., Laguna Salvadó, L., & Villeneuve, E. (2024). Tamarin (Version v1.9) [Computer software]. https://doi.org/10.5281/zenodo.13628740

bibtex @software{Masson_Tamarin_2024, author = {Masson, Dimitri and Laguna Salvadó, Laura and Villeneuve, Eric}, license = {MIT}, month = sep, title = {{Tamarin}}, url = {https://github.com/dhmmasson/tamarin}, version = {v1.9}, year = {2024} doi = {10.5281/zenodo.13628740} }

Owner

  • Name: Dimitri Masson
  • Login: dhmmasson
  • Kind: user
  • Location: Bidart, France
  • Company: Estia

Citation (CITATION.cff)

cff-version: 1.2.0
title: Tamarin
message: >-
  If you use this software, please cite it using the
  metadata from this file.
type: software
authors:
  - given-names: Dimitri
    family-names: Masson
    email: d.masson@estia.fr
    affiliation: ESTIA INSTITUTE OF TECHNOLOGY
    orcid: 'https://orcid.org/0000-0002-7072-3146'
  - given-names: Laura
    family-names: Laguna Salvadó
    orcid: 'https://orcid.org/0000-0002-6549-4393'
    affiliation: ESTIA INSTITUTE OF TECHNOLOGY
  - given-names: Eric
    family-names: Villeneuve
    orcid: 'https://orcid.org/0000-0003-0273-2267'
    affiliation: ESTIA INSTITUTE OF TECHNOLOGY
identifiers:
  - type: doi
    value: 10.5281/zenodo.13628740
repository-code: 'https://github.com/dhmmasson/tamarin'
url: 'https://dhmmasson.github.io/tamarin/static/'
abstract: >-
  Tamarin is an open-source **interactive alternative
  ranking system** for Multi-Criteria Decision-Making (MCDM)
  designed to help users select the optimal technology
  alternatives based on their preferences and criteria. The
  software integrates quantitative and qualitative data to
  rank alternatives, considering user-defined importance and
  uncertainty levels. Tamarin’s dynamic user interface
  allows real-time adjustments, enabling users to set for
  each criteria, importance, and granularity, and observe
  the impact on rankings. Built for flexibility, Tamarin
  supports various decision-making scenarios, including
  refurbishment technology selection, washing machine
  comparisons, or any decision involving evaluated
  alternatives provided through CSV files.
keywords:
  - Decision Support System
  - Multi Criteria Decision Making
  - Alternative Ranking
license: MIT
version: v1.9
date-released: '2024-09-02'

GitHub Events

Total
Last Year

Issues and Pull Requests

Last synced: about 1 year ago

All Time
  • Total issues: 19
  • Total pull requests: 39
  • Average time to close issues: 6 months
  • Average time to close pull requests: 9 months
  • Total issue authors: 1
  • Total pull request authors: 4
  • Average comments per issue: 0.05
  • Average comments per pull request: 0.67
  • Merged pull requests: 11
  • Bot issues: 0
  • Bot pull requests: 24
Past Year
  • Issues: 2
  • Pull requests: 0
  • Average time to close issues: 1 day
  • Average time to close pull requests: N/A
  • Issue authors: 1
  • Pull request authors: 0
  • Average comments per issue: 0.0
  • Average comments per pull request: 0
  • Merged pull requests: 0
  • Bot issues: 0
  • Bot pull requests: 0
Top Authors
Issue Authors
  • dhmmasson (19)
Pull Request Authors
  • dependabot[bot] (24)
  • dhmmasson (8)
  • Charlotte16 (4)
  • lea-estia (3)
Top Labels
Issue Labels
enhancement (9) bug (3) wontfix (2)
Pull Request Labels
dependencies (24)

Dependencies

package-lock.json npm
  • 680 dependencies
package.json npm
  • babel-eslint ^10.1.0 development
  • eslint ^6.8.0 development
  • jsdoc-to-markdown ^5.0.3 development
  • stylelint ^13.5.0 development
  • stylelint-config-recommended-scss ^4.2.0 development
  • stylelint-scss ^3.17.2 development
  • @svgdotjs/svg.draggable.js ^3.0.2
  • @svgdotjs/svg.js ^3.0.16
  • cookie-parser ^1.4.5
  • debug ~2.6.9
  • dotenv ^8.2.0
  • express ~4.16.1
  • http-errors ~1.6.3
  • jquery ^3.5.0
  • materialize-css ^1.0.0
  • morgan ~1.9.1
  • mysql2 ^2.1.0
  • node-sass-middleware 0.11.0
  • papaparse ^5.2.0
  • pug ^2.0.4
  • statistics.js ^1.0.0
routes/package.json npm