Skip to content

docs(guides): expliquer densité et largeur des classes - #31

Merged
ElouenGinat merged 9 commits into
mainfrom
docs/histogram-density-guide
Sep 14, 2026
Merged

ElouenGinat merged 9 commits into
mainfrom
docs/histogram-density-guide

Conversation

@ElouenGinat

Copy link
Copy Markdown
Collaborator

What

  • ajoute un guide visuel sur les effectifs, les densités et les classes de largeur variable
  • met à jour les liens vers la documentation officielle des histogrammes Khiops
  • met en avant cette ressource sur la page d’accueil avec un composant conforme à Orange Boosted

Why

Clarifier l’interprétation des histogrammes adaptatifs et éviter de comparer directement les hauteurs d’effectifs lorsque les classes ont des largeurs différentes.

How to test

uv run --group docs sphinx-build -W --keep-going -b html docs docs/_build/html

Le rendu a également été vérifié en modes clair et sombre, sur desktop et mobile.

@github-actions

github-actions Bot commented Sep 9, 2026

Copy link
Copy Markdown
PR Preview Action v1.8.1
Preview removed because the pull request was closed.
2026-09-14 16:33 UTC

@marcboulle marcboulle left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

L'explication sur la densité me parait très bien:

  • quelques suggestion de détail
  • à valider avec les utilsateurs, si possible

Installation sur Windows: résoudre si possible

Passage à la 1.0.2: prématuré, attendre que les autres problèmes connus soient résolus

within that interval. When bin widths vary, height alone is not enough:
probability is represented by the bar's area, calculated as density multiplied
by bin width.

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

For a detailed introduction to density and variable-width bins
->
Note that variable-width bins are ideal for unbalanced distributions and outliers, as shown in [Histograms - Khiops].

Copy link
Copy Markdown
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

done

@ElouenGinat ElouenGinat Sep 14, 2026

Copy link
Copy Markdown
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

image I added back this section. I had a reviewer telling me he liked it (it's maybe a little too long... What are your recommandations?

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

L'utilisateur est clairement prioritaire; il faut donc garder ce tableau.

Par contre, corriger:
"Counts divided by 𝑁
, or density"
=>
"Counts divided by 𝑁
, or density times bin width"

Copy link
Copy Markdown
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

done

Comment thread scripts/generate_distribution_examples.py Outdated
Comment thread README.md Outdated
On Windows, install [Visual Studio Build Tools 2022](https://visualstudio.microsoft.com/visual-cpp-build-tools/)
with the **Desktop development with C++** workload. Then run the commands below
from an **x64 Native Tools Command Prompt for VS 2022** and verify that the
compiler is available with `where cl`.

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Ce serait vraiment un plus de résoudre le problème d'installation sur Windows.
Sur mon poste, j'ai un Visual Studio installé, et je n'ai aucun problème avec le repo khiops concernant le compilateur C++, alors que j'ai eu des erreurs avec khisto-python.

Copy link
Copy Markdown
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Can you retry on your desktop plz ?

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

En me plaçant sur la branche de la PR et en relançant uv sync --group dev --extra all, je n'ai plus d'erreur, et le khisto.exe est compilé dans .venv\Scripts.

Par contre, le where cl me renvoie Information : impossible de trouver des fichiers pour le(s) modèle(s) spécifié(s).

Soit on résout ce nouveau problème, soit on vire la fin de phrase and verify that the compiler is available withwhere cl`, peut-être pas très pertinente ici.

Comment thread docs/index.rst Outdated

@marcboulle marcboulle left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Quelques petits détails à régler (cf. commentaires).

Plus remarques concernant la partie "Counts vs density":

  • le titre est sur deux lignes, alors que j'ai largement la place sur mon écran
  • il y a une barre verticale de pointillés entre les figures de gauche et celle de droite, qui coup le libellés de l'axe des Y des figures de droite
Image

@ElouenGinat
ElouenGinat merged commit 40526ec into main Sep 14, 2026
16 checks passed
@ElouenGinat
ElouenGinat deleted the docs/histogram-density-guide branch September 14, 2026 16:33
# Publish to GH pages on Git tag push
preview:
if: >-
always() &&

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

What does always() add here, as it is always true? I would consider removing it.

Copy link
Copy Markdown
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

always() permet d’exécuter ce job lorsque build est skipped, notamment à la fermeture d’une PR. Sans lui, GitHub Actions applique implicitement success() et ignore preview, empêchant ainsi la suppression de l’aperçu. Je propose donc de le conserver.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants