Giter Site home page Giter Site logo

mimbcd-ui / prototype-assertive-proactive Goto Github PK

View Code? Open in Web Editor NEW
0.0 5.0 1.0 2.91 MB

📈 [CHI 2023] UTA11: Prototype of the assertive and proactive trial for the Assertiveness-based BreastScreening-AI condition.

Home Page: https://mimbcd-ui.github.io/prototype-assertive-proactive/

License: Other

JavaScript 81.30% CSS 0.85% Java 14.37% HTML 3.48%
intelligent-agent chi2023 human-computer-interaction prototype user-centered-design artificial-intelligence

prototype-assertive-proactive's Introduction

Assertive and Proactive Prototype

OpenCollective OpenCollective Gitter Twitter

Welcome to the results repository for our paper "Assertiveness-based Agent Communication for a Personalized Medicine on Medical Imaging Diagnosis" (10.1145/3544548.3580682) in proceedings of the 2023 CHI Conference on Human Factors in Computing Systems (CHI '23) presented during the "AI in Health" track. In this repository, we aim to develop a prototype of the assertive and proactive trial for the Assertiveness-based BreastScreening-AI condition. The prototype is based on an early developed version of the BreastScreening prototype. To test and validate the prototype, initial User Research studies with the prototype are linked (10.13140/RG.2.2.22989.92645/1). A number of advantages over the introduction of our novel proposed type of interactive techniques appear to be evident. Furthermore, we develop the prototype the MIDA project as well. The MIDA project is a research project that deals with the use of a recently proposed technique in literature: Deep Convolutional Neural Networks (CNNs). These deep networks will incorporate information from several different modes by a User Interface (UI) implemented based on our later prototypes. We also have several channels and demos to see in our YouTube Channel, please follow us!

Citing

We kindly ask scientific works and studies that make use of the repository to cite it in their associated publications. Similarly, we ask open-source and closed-source works that make use of the repository to warn us about this use.

You can cite our work using the following BibTeX entry:

@inproceedings{10.1145/3544548.3580682,
author = {Calisto, Francisco Maria and Fernandes, Jo\~{a}o and Morais, Margarida and Santiago, Carlos and Abrantes, Jo\~{a}o Maria and Nunes, Nuno and Nascimento, Jacinto C.},
title = {Assertiveness-Based Agent Communication for a Personalized Medicine on Medical Imaging Diagnosis},
year = {2023},
isbn = {9781450394215},
publisher = {Association for Computing Machinery},
address = {New York, NY, USA},
url = {https://doi.org/10.1145/3544548.3580682},
doi = {10.1145/3544548.3580682},
abstract = {Intelligent agents are showing increasing promise for clinical decision-making in a variety of healthcare settings. While a substantial body of work has contributed to the best strategies to convey these agents’ decisions to clinicians, few have considered the impact of personalizing and customizing these communications on the clinicians’ performance and receptiveness. This raises the question of how intelligent agents should adapt their tone in accordance with their target audience. We designed two approaches to communicate the decisions of an intelligent agent for breast cancer diagnosis with different tones: a suggestive (non-assertive) tone and an imposing (assertive) one. We used an intelligent agent to inform about: (1) number of detected findings; (2) cancer severity on each breast and per medical imaging modality; (3) visual scale representing severity estimates; (4) the sensitivity and specificity of the agent; and (5) clinical arguments of the patient, such as pathological co-variables. Our results demonstrate that assertiveness plays an important role in how this communication is perceived and its benefits. We show that personalizing assertiveness according to the professional experience of each clinician can reduce medical errors and increase satisfaction, bringing a novel perspective to the design of adaptive communication between intelligent agents and clinicians.},
booktitle = {Proceedings of the 2023 CHI Conference on Human Factors in Computing Systems},
articleno = {13},
numpages = {20},
keywords = {Clinical Decision Support System, Healthcare, Breast Cancer},
location = {Hamburg, Germany},
series = {CHI '23}
}

Instructions

First of all, you will need NodeJS (< [v16.20.0](https://nodejs.org/en/blog/release/v16.20.0)) installed locally on your machine. This project needs both npm and http-server dependencies to install and run the core project. If you do not have those installed please follow the INSTALL instructions.

DICOM Server

The following assumes you will be using a git version control for this repository, storing thanks to GitHub. First, Download and Install git. Our system needs to be integrated with WADO-URI servers, DICOMWeb servers or any HTTP based server that returns a DICOM P10 instances. We suggest you to use an Orthanc server, since it is a simple and powerful standalone DICOM server by providing a RESTful API.

You can download a latest version or you can use our own sample of an Orthanc version with our examples of patient images. The instructions to use our solution are as follows.

Clone

1.1.1. Clone the DICOM Server repository:

git clone [email protected]:MIMBCD-UI/dicom-server.git

1.1.2. Go inside the project folder:

cd dicom-server/

Install

1.2.1. Install the local dependencies:

npm install

1.2.2. You can now Run the project, just follow the next section.

Run

1.3.1. Inside the project folder:

cd dicom-server

1.3.2. Start the DICOM Server (Orthanc) for MacOS:

npm run start:multi

OR

cd ..
cd dicom-server/orthancAndPluginsOSX.stable/
./startOrthanc.command

NOTE: If you are not using MacOS, for instance, if you are using Windows or Debian you have a documentation for that. Just follow the Windows or Debian documentations. You also have several other options.

1.3.3. Open the link:

localhost:8248

NOTE: If you need some help see the Demo.

Main Server

Our main server uses NodeJS and has several dependencies. For the following steps you must have already installed both NodeJS and npm in your machine.

Clone

2.1.1. Clone the project repository:

git clone [email protected]:MIMBCD-UI/prototype-assertive-proactive.git

2.1.2. Go inside the project folder:

cd prototype-assertive-proactive/

Install

2.2.1. Install the local dependencies:

npm install

2.2.2. You can now Run the project, just follow the next section.

Run

2.3.1. Inside the project folder:

cd prototype-assertive-proactive/

2.3.2. If you have already run the DICOM Server on a previous section, please jump to the 2.3.3. point, otherwise do:

npm run dicom-server

2.3.3. Run the code:

npm run build:local

2.3.4. Start the project:

npm run start:local

2.3.5. Open the link:

localhost:8286/src/public/index.html
Allow-Control-Allow-Origin

Access-Control-Allow-Origin is a CORS (Cross-Origin Resource Sharing) header. If you want to know How does Access-Control-Allow-Origin header work? follow the link.

Google Chrome
  • To deal with the CORS issue it is necessary to open Google Chrome with --disable-web-security flag on:
open /Applications/Google\ Chrome.app --args --disable-web-security --user-data-dir

Information

The current information will summarize the essential parts of this repository. In addition to related resources, we address all significant parts that were crucial to the present information.

Related Repositories

The following list, represents the set of related repositories for the presented one:

Dataset Resources

To publish our datasets we used a well known platform called Kaggle. To access these datasets just follow the uta4-sm-vs-mm-sheets dataset, as an example. Here, you will find all of our published datasets and any associated information, such as descriptions and download links. We are also working on several other User Research studies, while this repository is being an important asset to them.

About

For more information about the MIDA project just follow the link. Pieces of information about details of this repository are also in a wiki. This prototype was developed using several libraries and dependencies. Despite that all libraries had their importance and supported the development, one of it was of chief importance. The CornerstoneJS library and secondary libraries, respectively, are supporting this prototype. We Acknowledge all people involved in the path.

License

Copyright © 2021 Instituto Superior Técnico

Creative Commons License

The prototype-assertive-proactive repository is distributed under the terms of both Academic License for academic purpose and Commercial License for commercial purpose, as well as under the CC-BY-SA-4.0 copyright. The content of the present repository has obtained the patent right of World Intellectual Property Organization (WIPO) invention. Moreover, the hereby invention for this repository is under protection of the patent number WO2022071818A1 with the application number PCT/PT2021/050029. The title of the invention is "Computational Method and System for Improved Identification of Breast Lesions", registered under the WO patent office.

See ACADEMIC and COMMERCIAL for details. For more information about the MIMBCD-UI Project just follow the link.

Acknowledgments

A special thanks to Chris Hafey, the propelling person of CornerstoneJS, who also developed the cornerstoneDemo. Not forgetting the three supporters of the CornerstoneJS library, Aloïs Dreyfus, Danny Brown and Erik Ziegler. We also would like to give a special thanks to Erik Ziegler who support several issues during this path.

Team

Our team brings everything together sharing ideas and the same purpose, developing even better work. In this section, we will nominate the full list of important people for this repository, as well as respective links.

Authors

Promoters

  • Hugo Lencastre
  • Nádia Mourão
  • Miguel Bastos
  • Pedro Diogo
  • João Bernardo
  • Madalena Pedreira
  • Mauro Machado

Companions

  • Bruno Dias
  • Bruno Oliveira
  • Luís Ribeiro Gomes
  • Pedro Miraldo

Supporting

Our organization is a non-profit organization. However, we have many needs across our activity. From infrastructure to service needs, we need some time and contribution, as well as help, to support our team and projects.

Contributors

This project exists thanks to all the people who contribute. [Contribute].

Backers

Thank you to all our backers! 🙏 [Become a backer]

Sponsors

Support this project by becoming a sponsor. Your logo will show up here with a link to your website. [Become a sponsor]


fct fccn ulisboa ist hff chtmad
Departments
dei dei
Laboratories
sipg isr larsys iti inesc-id
Domain
eu pt

prototype-assertive-proactive's People

Contributors

fmcalisto avatar jgmf99 avatar

Watchers

 avatar  avatar  avatar  avatar  avatar

prototype-assertive-proactive's Issues

Closing Patient Assistant Bug

When you close the patient and come back to the list of patients, the message is still visible. This is a bug that must be fixed soon. Otherwise, it will compromise the user tests.

issue003

Improve image visualization

After the feedback from the report presentation, it was decided to add some information in the medical image.
For that, an initial implementation for calcifications and masses:

  • Calcifications - circle around a cluster and respective distribution
  • Masses - text with shape, margin and density if it was found

Installation Problems

There are some errors concerning the installation process of the prototype in our remote server. These problems are related to the versions of some used dependencies. As we can see, there will exist some conflicts in your source code if we choose to address the issue directly inside the remote server. Please try to fix and resolve those concerns.

First, try to run the next command:

npm audit

Next, try to resolve the problem with the next command:

npm audit fix

From here, you will see that there are some collisions and conflicts in your source code. Indeed, this concern must be addressed by you first so that we can finish the installation in the remote server.

As follows, it is representative of what is being discussed here:

sample001

Fix package.json

package.json file has incorrect information regarding current repository.

GitIgnore Workflow

Please attempt to replicate what I did in the last commit (i.e., e54f584) into the other three prototypes. Moreover, it might be important to update the .gitingnore file with information about the severities.

Cleaning Configurations

We need to clean the config/ folder. Just let there the files sample-env.json and sample-local.json serving as samples. The other files are to be deleted.

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.