Skip to content

Dev #20

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
homarone00 merged 2 commits into from
Jun 23, 2026
Merged

Dev #20

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
05d88b9
added videos to the website
homarone00 Jun 23, 2026
17f660b
Merge pull request #19 from AImageLab-zip/dev-ocarpentiero
homarone00 Jun 23, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
1 change: 1 addition & 0 deletions .gitignore
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1 +1,2 @@
.env
*.mov
Binary file added assets/yggdrasil.png
View file
Open in desktop
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
50 changes: 24 additions & 26 deletions clinicians.html
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -37,12 +37,10 @@
<section id="top" class="hero">
<div class="hero-content">
<div class="hero-copy clinicians-it-content">
<p class="eyebrow">Guida per annotatori</p>
<h1>Guida ReportX per gli Annotatori</h1>
<p>Protocollo di annotazione, campi di annotazione ed esempi.</p>
</div>
<div class="hero-copy clinicians-en-content">
<p class="eyebrow">Annotator guide</p>
<h1>ReportX Annotators Guide</h1>
<p>Annotation protocol, annotation fields, and examples.</p>
</div>
Expand All @@ -54,33 +52,32 @@ <h1>ReportX Annotators Guide</h1>

<section class="section alt clinicians-it-content">
<div class="section-heading">
<p class="eyebrow">Obiettivo</p>
<h2>Annotazione del dataset BraTS2023 completo</h2>
</div>
<div class="prose">
<p>Vogliamo annotare l'intero dataset BraTS2023 seguendo un protocollo uniforme, così che ogni referto sia chiaro, confrontabile e utilizzabile per analisi successive.</p>
<p>I referti saranno letti e processati anche da sistemi automatici. Per questo è importante descrivere ogni reperto in modo preciso, esplicito e standardizzato, evitando formulazioni ambigue o troppo variabili tra casi simili.</p>
<p>Quando descrivi un finding, usa sempre la stessa logica: indica la sede, specifica la componente tumorale coinvolta quando rilevante e riporta la caratteristica osservata. Mantieni lo stesso modo di spiegare concetti ricorrenti, così il testo resta naturale per l'annotatore ma più facilmente interpretabile dalla macchina.</p>
</div>
<p class="feedback-note">Per dubbi, problemi o suggerimenti: <a href="mailto:omar.carpentiero@unimore.it?subject=Feedback%20BraTS%20Reports%20annotatori">omar.carpentiero@unimore.it</a></p>
<p class="highlight-note">L'articolo derivato verrà sottoposto a <strong>Nature</strong>. Tutti gli annotatori i cui referti superano il controllo di qualità saranno inclusi come autori.</p>
<p class="feedback-note">Per dubbi, problemi o suggerimenti: <a href="mailto:reportx@unimore.it?subject=Feedback%20BraTS%20Reports%20annotatori">reportx@unimore.it</a></p>
</section>

<section class="section alt clinicians-en-content">
<div class="section-heading">
<p class="eyebrow">Goal</p>
<h2>Annotation of the full BraTS2023 dataset</h2>
</div>
<div class="prose">
<p>We want to annotate the full BraTS2023 dataset using a uniform protocol, so that every report is clear, comparable, and suitable for downstream analysis.</p>
<p>The reports will also be read and processed by automatic systems. For this reason, each finding should be described precisely, explicitly, and consistently, avoiding ambiguous wording or excessive variation across similar cases.</p>
<p>When describing a finding, follow the same structure whenever possible: state the location, specify the tumor component involved when relevant, and report the observed characteristic. Keep recurring concepts phrased consistently, so the text remains natural for the annotator while being easier for machines to interpret.</p>
</div>
<p class="feedback-note">For questions, issues, or suggestions: <a href="mailto:omar.carpentiero@unimore.it?subject=BraTS%20Reports%20annotator%20feedback">omar.carpentiero@unimore.it</a></p>
<p class="highlight-note">The resulting paper will be submitted to <strong>Nature</strong>. Every annotator whose reports pass the quality check will be included as an author.</p>
<p class="feedback-note">For questions, issues, or suggestions: <a href="mailto:reportx@unimore.it?subject=BraTS%20Reports%20annotator%20feedback">reportx@unimore.it</a></p>
</section>

<section id="dataset-release" class="section dataset-content">
<div class="section-heading">
<p class="eyebrow">Reference</p>
<h2>Tumor Region Legend</h2>
</div>
<div class="table-wrap">
Expand Down Expand Up @@ -119,7 +116,6 @@ <h2>Tumor Region Legend</h2>

<section class="section dataset-content">
<div class="section-heading">
<p class="eyebrow">Template</p>
<h2>Field Definitions</h2>
</div>
<div class="table-wrap wide-table">
Expand Down Expand Up @@ -302,7 +298,6 @@ <h2>Field Definitions</h2>

<section id="clinicians-en" class="section clinicians-en-content">
<div class="section-heading">
<p class="eyebrow">English version</p>
<h2>ReportX Dataset Template</h2>
<p>Structured definition of dataset fields for reporting on ToothFairy4M.</p>
</div>
Expand Down Expand Up @@ -343,7 +338,6 @@ <h2>ReportX Dataset Template</h2>

<section class="section clinicians-en-content">
<div class="section-heading">
<p class="eyebrow">Annotation fields</p>
<h2>Field Definitions</h2>
</div>
<div class="field-grid">
Expand Down Expand Up @@ -506,7 +500,6 @@ <h3>Subject-Specific Findings</h3>

<section class="section alt clinicians-en-content">
<div class="section-heading">
<p class="eyebrow">Annotation</p>
<h2>Annotation Protocol</h2>
</div>
<div class="prose">
Expand All @@ -518,7 +511,6 @@ <h2>Annotation Protocol</h2>

<section class="section clinicians-en-content">
<div class="section-heading">
<p class="eyebrow">Classification</p>
<h2>Multifocal, Multicentric, Single</h2>
<p>The annotation protocol defines specific and objective criteria to classify a lesion as single, multifocal, or multicentric. ED is shown in red, NETC in green, and ET in blue.</p>
</div>
Expand Down Expand Up @@ -571,7 +563,6 @@ <h2>Multifocal, Multicentric, Single</h2>

<section class="section alt clinicians-en-content">
<div class="section-heading">
<p class="eyebrow">Example</p>
<h2>Example Original Report</h2>
<p>The example report represents the model to follow when compiling the annotation.</p>
</div>
Expand Down Expand Up @@ -606,7 +597,6 @@ <h2>Example Original Report</h2>

<section class="section clinicians-en-content">
<div class="section-heading">
<p class="eyebrow">Mapping</p>
<h2>Report Decomposed According to the Template</h2>
<p>This decomposition shows how each template field corresponds to information in the free-text report.</p>
</div>
Expand Down Expand Up @@ -707,17 +697,21 @@ <h2>Report Decomposed According to the Template</h2>

<section class="section alt clinicians-en-content">
<div class="section-heading">
<p class="eyebrow">Platform</p>
<h2>Using the ToothFairy4M Platform</h2>
<h2>Using the Yggdrasil Platform</h2>
</div>
<div class="prose">
<p>Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incidunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrum exercitationem ullamco laboriosam, nisi ut aliquid ex ea commodi consequatur.</p>
<p>The annotation platform is available at <a class="platform-link" href="https://yggdrasil.ing.unimore.it" target="_blank" rel="noopener">yggdrasil.ing.unimore.it</a>.</p>
<p>All annotation work will be carried out on the Yggdrasil platform.</p>
<p>For any problems, please contact <a href="mailto:reportx@unimore.it">reportx@unimore.it</a>.</p>
</div>
<p class="video-label">Here's a quick tutorial:</p>
<div class="video-wrap">
<video controls width="100%" poster="assets/yggdrasil.png" src="videos/reportx_eng.mov"></video>
</div>
</section>

<section id="clinicians-it" class="section clinicians-it-content">
<div class="section-heading">
<p class="eyebrow">Versione italiana</p>
<h2>Template del Dataset ReportX</h2>
<p>Definizione strutturata dei campi del dataset per la refertazione su ToothFairy4M.</p>
</div>
Expand Down Expand Up @@ -758,7 +752,6 @@ <h2>Template del Dataset ReportX</h2>

<section class="section clinicians-it-content">
<div class="section-heading">
<p class="eyebrow">Campi di annotazione</p>
<h2>Definizione dei Campi</h2>
</div>
<div class="field-grid">
Expand Down Expand Up @@ -921,7 +914,6 @@ <h3>Reperti Specifici del Soggetto</h3>

<section id="protocol" class="section alt clinicians-it-content">
<div class="section-heading">
<p class="eyebrow">Annotazione</p>
<h2>Protocollo di Annotazione</h2>
</div>
<div class="prose">
Expand All @@ -933,7 +925,6 @@ <h2>Protocollo di Annotazione</h2>

<section class="section clinicians-it-content">
<div class="section-heading">
<p class="eyebrow">Classificazione</p>
<h2>Multifocale, Multicentrico, Singolo</h2>
<p>Nel protocollo sono definiti criteri specifici e oggettivi per classificare una lesione come singola, multifocale o multicentrica. ED è indicato in rosso, NETC in verde ed ET in blu.</p>
</div>
Expand Down Expand Up @@ -986,7 +977,6 @@ <h2>Multifocale, Multicentrico, Singolo</h2>

<section id="example" class="section alt clinicians-it-content">
<div class="section-heading">
<p class="eyebrow">Esempio</p>
<h2>Esempio di Referto Originale</h2>
<p>Il referto di esempio rappresenta il modello da seguire per la compilazione.</p>
</div>
Expand Down Expand Up @@ -1021,7 +1011,6 @@ <h2>Esempio di Referto Originale</h2>

<section class="section clinicians-it-content">
<div class="section-heading">
<p class="eyebrow">Mapping</p>
<h2>Referto Scomposto secondo il Template</h2>
<p>Questa scomposizione mostra come ciascun campo del template trovi una corrispondenza nel testo libero.</p>
</div>
Expand Down Expand Up @@ -1122,11 +1111,16 @@ <h2>Referto Scomposto secondo il Template</h2>

<section class="section alt clinicians-it-content">
<div class="section-heading">
<p class="eyebrow">Piattaforma</p>
<h2>Utilizzo della piattaforma ToothFairy4M</h2>
<h2>Utilizzo della piattaforma Yggdrasil</h2>
</div>
<div class="prose">
<p>Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incidunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrum exercitationem ullamco laboriosam, nisi ut aliquid ex ea commodi consequatur.</p>
<p>La piattaforma di annotazione è disponibile su <a class="platform-link" href="https://yggdrasil.ing.unimore.it" target="_blank" rel="noopener">yggdrasil.ing.unimore.it</a>.</p>
<p>Tutto il lavoro di refertazione verrà fatto sulla piattaforma Yggdrasil.</p>
<p>Per qualsiasi problema, contattare <a href="mailto:reportx@unimore.it">reportx@unimore.it</a>.</p>
</div>
<p class="video-label">Ecco un breve tutorial:</p>
<div class="video-wrap">
<video controls width="100%" poster="assets/yggdrasil.png" src="videos/reportx_ita.mov"></video>
</div>
</section>
</main>
Expand All @@ -1143,6 +1137,10 @@ <h2>Utilizzo della piattaforma ToothFairy4M</h2>
document.querySelectorAll('input[name="language"]').forEach((input) => {
input.addEventListener('change', () => {
document.body.dataset.lang = input.id === 'lang-en' ? 'en' : 'it';
document.querySelectorAll('.video-wrap video').forEach((video) => {
video.pause();
video.load();
});
});
});
</script>
Expand Down
21 changes: 8 additions & 13 deletions dataset-release.html
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -30,7 +30,6 @@
</nav>
<section id="top" class="hero">
<div class="hero-copy">
<p class="eyebrow">ReportX instructions hub</p>
<h1>One template, three ways in.</h1>
<p>
Pick the documentation path you need: dataset release fields, the Italian
Expand All @@ -55,7 +54,6 @@ <h1>One template, three ways in.</h1>
<main>
<section id="dataset-release" class="section dataset-content">
<div class="section-heading">
<p class="eyebrow">Reference</p>
<h2>Tumor Region Legend</h2>
</div>
<div class="table-wrap">
Expand Down Expand Up @@ -94,7 +92,6 @@ <h2>Tumor Region Legend</h2>

<section class="section dataset-content">
<div class="section-heading">
<p class="eyebrow">Template</p>
<h2>Field Definitions</h2>
</div>
<div class="table-wrap wide-table">
Expand Down Expand Up @@ -277,7 +274,6 @@ <h2>Field Definitions</h2>

<section id="clinicians-en" class="section alt clinicians-en-content">
<div class="section-heading">
<p class="eyebrow">Annotator guide</p>
<h2>Annotators Version in English</h2>
<p>Free-text reporting instructions and annotator-facing fields translated from the Italian annotation guide.</p>
</div>
Expand Down Expand Up @@ -382,7 +378,6 @@ <h2>Annotators Version in English</h2>

<section id="clinicians-it" class="section clinicians-it-content">
<div class="section-heading">
<p class="eyebrow">Versione italiana</p>
<h2>Template del Dataset ReportX</h2>
<p>Definizione strutturata dei campi del dataset per la refertazione su ToothFairy4M.</p>
</div>
Expand Down Expand Up @@ -423,7 +418,6 @@ <h2>Template del Dataset ReportX</h2>

<section class="section clinicians-it-content">
<div class="section-heading">
<p class="eyebrow">Campi di annotazione</p>
<h2>Definizione dei Campi</h2>
</div>
<div class="field-grid">
Expand Down Expand Up @@ -560,7 +554,6 @@ <h3>Reperti Specifici del Soggetto</h3>

<section id="protocol" class="section alt clinicians-it-content">
<div class="section-heading">
<p class="eyebrow">Annotazione</p>
<h2>Protocollo di Annotazione</h2>
</div>
<div class="prose">
Expand All @@ -572,7 +565,6 @@ <h2>Protocollo di Annotazione</h2>

<section class="section clinicians-it-content">
<div class="section-heading">
<p class="eyebrow">Classificazione</p>
<h2>Multifocale, Multicentrico, Singolo</h2>
<p>Nel protocollo sono definiti criteri specifici e oggettivi per classificare una lesione come singola, multifocale o multicentrica. ED è indicato in rosso, NETC in verde ed ET in blu.</p>
</div>
Expand Down Expand Up @@ -625,7 +617,6 @@ <h2>Multifocale, Multicentrico, Singolo</h2>

<section id="example" class="section alt clinicians-it-content">
<div class="section-heading">
<p class="eyebrow">Esempio</p>
<h2>Esempio di Referto Originale</h2>
<p>Il referto di esempio rappresenta il modello da seguire per la compilazione.</p>
</div>
Expand All @@ -640,7 +631,6 @@ <h2>Esempio di Referto Originale</h2>

<section class="section clinicians-it-content">
<div class="section-heading">
<p class="eyebrow">Mapping</p>
<h2>Referto Scomposto secondo il Template</h2>
<p>Questa scomposizione mostra come ciascun campo del template trovi una corrispondenza nel testo libero.</p>
</div>
Expand Down Expand Up @@ -741,11 +731,16 @@ <h2>Referto Scomposto secondo il Template</h2>

<section class="section alt clinicians-it-content">
<div class="section-heading">
<p class="eyebrow">Piattaforma</p>
<h2>Utilizzo della piattaforma ToothFairy4M</h2>
<h2>Utilizzo della piattaforma Yggdrasil</h2>
</div>
<div class="prose">
<p>Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incidunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrum exercitationem ullamco laboriosam, nisi ut aliquid ex ea commodi consequatur.</p>
<p>La piattaforma di annotazione è disponibile su <a class="platform-link" href="https://yggdrasil.ing.unimore.it" target="_blank" rel="noopener">yggdrasil.ing.unimore.it</a>.</p>
<p>Tutto il lavoro di refertazione verrà fatto sulla piattaforma Yggdrasil.</p>
<p>Per qualsiasi problema, contattare <a href="mailto:reportx@unimore.it">reportx@unimore.it</a>.</p>
</div>
<p class="video-label">Ecco un breve tutorial:</p>
<div class="video-wrap">
<video controls width="100%" poster="assets/yggdrasil.png" src="videos/reportx_ita.mov"></video>
</div>
</section>
</main>
Expand Down
1 change: 1 addition & 0 deletions docker-compose.yml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -5,6 +5,7 @@ services:
restart: unless-stopped
volumes:
- .:/usr/share/nginx/html:ro
- ../videos:/usr/share/nginx/html/videos:ro
ports:
# http://ReportX.unimore.it:8096 → nginx
- "8096:8080"
Expand Down
8 changes: 6 additions & 2 deletions feedback.html
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -52,6 +52,10 @@
<a class="brand" href="index.html" aria-label="ReportX home">
<span class="brand-name">ReportX</span>
</a>
<a class="powered-by" href="https://aimagelab.unimore.it/" aria-label="Powered by AI Image Lab">
<span>Powered by</span>
<img src="assets/logo_full.svg" alt="AImageLab" class="aimagelab-logo">
</a>
</div>
<div class="nav-links">
<a href="clinicians.html">Annotators</a>
Expand All @@ -66,8 +70,8 @@
<div class="feedback-page">
<h1>Feedback &amp; Issues</h1>
<p>For any feedback, bug reports, or questions about ReportX, please reach out by email.</p>
<a class="email-link" href="mailto:omar.carpentiero@unimore.it?subject=ReportX%20feedback">
omar.carpentiero@unimore.it
<a class="email-link" href="mailto:reportx@unimore.it?subject=ReportX%20feedback">
reportx@unimore.it
</a>
</div>
</main>
Expand Down
Loading
Loading