Aller au contenu
Version du document v2026.10.17.0
Télécharger le PDF

Comparer deux révisions de carte (Board Diff)

Cette passe n’a vérifié que l’entrée bibliothèque Compare Revisions…. Le flux de comparaison ci-dessous n’a pas été réexécuté le 2026-09-11. Ne considérez pas cette page comme un compte rendu d’acceptation Diff complet pour la construction actuelle.

Objectif de la page

Vous aider à lancer Board Diff depuis les révisions de la bibliothèque, comprendre la direction Before / After, inspecter les changements objet par objet, et exporter un JSON ou un PNG relisible.

Plateformes prises en charge

  • macOS 14 ou version ultérieure : l’expérience large principale et la première plateforme d’acceptation de Board Diff aujourd’hui.
  • iOS / iPadOS 17.0 ou version ultérieure : l’entrée est fournie avec l’application. Préférez le paysage ou une fenêtre plus large ; l’optimisation dédiée aux écrans étroits reste un travail de suivi.

Public concerné

  • Concepteurs, fabricants ou réviseurs qui doivent comparer deux révisions du même PCB
  • Testeurs qui doivent accepter un Diff selon la direction, la couche, l’objet et les indices de risque

Prérequis

Choisissez une paire de cartes dont les contenus diffèrent mais dont les formats réellement analysés sont identiques :

Entrée État actuel
DSN Pris en charge
KiCad .kicad_pcb d’une seule carte Pris en charge
Dossier ou archive Gerber + Excellon Pris en charge
SES Pris en charge seulement lorsque les deux côtés peuvent être vérifiés et pointent vers la même conception de base
ODB++, IPC-2581, PCB / bibliothèque Altium, projet KiCad complet Explicitement non pris en charge pour Board Diff aujourd’hui

Before et After sont directionnels :

  • Added : n’existe que dans After.
  • Removed : n’existe que dans Before.
  • Modified : les objets des deux côtés peuvent être appariés, mais les attributs ou la géométrie diffèrent.
  • Unchanged : identique des deux côtés, affiché seulement comme contexte.

La même extension de fichier ne garantit pas le même format. PCBAtlas analyse chaque côté séparément, puis décide si la comparaison est possible.

Étapes

Comparer deux révisions dans la bibliothèque

  1. Dans la bibliothèque, trouvez un document avec au moins deux révisions.
  2. Ouvrez le menu d’actions supplémentaires de la carte du document.
  3. Cliquez sur Compare Revisions….
  4. Dans Before et After, choisissez deux révisions différentes de même format.
  5. Cliquez sur Compare.

Si la révision courante a un parent, la page préfère le parent comme Before et la révision courante comme After. Vous pouvez toujours changer chaque côté manuellement.

Une comparaison hébergée terminée enregistre un artefact validé. La prochaine fois que vous entrez dans la page de comparaison du même document, vous pouvez utiliser Reopen Saved Comparison.

Confirmer un appariement de couches ambigu

Si PcbCore trouve plusieurs candidats compatibles, la comparaison s’interrompt sur Layer pairing needs confirmation :

  1. Pour chaque couche Before, contrôlez le nom, le rôle, l’ordre et le nombre d’objets.
  2. À droite, choisissez la After layer correcte.
  3. Confirmez que chaque élément a une sélection.
  4. Cliquez sur Confirm and Compare pour relancer.

PCBAtlas ne devine pas une couche lorsque l’appariement est ambigu, et n’aligne pas de force deux cartes par translation / rotation automatique. Une translation ou une rotation de la carte entière est conservée comme un vrai changement.

Attendre ou annuler la comparaison

La comparaison affiche la progression : validation d’entrée, import Before / After, appariement des couches, instantané, correspondance géométrique, analyse de risque, scène Diff et persistance.

Après un clic sur Cancel, attendez la fin de Cancelling comparison…. La page n’autorise une nouvelle tentative sûre qu’une fois les deux sessions natives et les données temporaires de préparation libérées.

Lire l’espace de travail de comparaison

Modes d’affichage

  • Overlay : superpose les changements dans une scène composite exacte ; Context contrôle l’intensité du contexte inchangé.
  • Split : Before à gauche, After à droite ; Sync Camera est activé par défaut, et le désactiver permet d’inspecter chaque côté séparément.
  • Blink : bascule automatiquement Before / After avec la même caméra, utile pour les petits déplacements.
  • Fit : réadapte la scène courante à la zone visible.

Couches et changements

  • Layer Pairs à gauche affiche les résultats d’appariement et le nombre de changements de chaque paire.
  • Choisissez All layers pour toute la carte, ou une paire de couches pour réduire la portée.
  • Changes à droite peut activer ou désactiver Added / Removed / Modified et filtrer par type d’objet et Net.
  • Un clic sur une ligne de changement localise et met l’objet en surbrillance ; une sélection dans Viewer recherche aussi le changement correspondant.
  • Previous / Next parcourent les résultats filtrés courants ; les raccourcis macOS sont ⌘[ et ⌘].
  • Le panneau Risks filtre les indices directionnels par niveau de risque. Les indices de risque servent à localiser la revue, et ne remplacent pas un DRC ni une validation de fabrication.

Inverser la direction, exporter et rouvrir

  • Swap crée une demande inversée et recalcule ; Added / Removed d’origine, statistiques, risques et détails s’inversent avec la direction.
  • JSON exporte un résultat sémantique stable et versionné ; iOS remet le fichier à d’autres applications.
  • PNG exporte une capture de la vue Diff courante ; iOS l’enregistre directement dans Photos, tandis que macOS continue d’utiliser l’interface système de livraison de fichiers.
  • Après une comparaison de révisions hébergée, rouvrez le résultat validé depuis Reopen Saved Comparison.
  • Si le contenu de révision, le format, la politique ou l’appariement des couches a changé, l’ancien artefact est traité comme invalide au lieu d’afficher silencieusement un résultat périmé.

Shell large et shell étroite

Les deux dispositions lancent la comparaison depuis le menu d’actions du document dans la bibliothèque. N’utilisez pas le Split ordinaire de Viewer à la place de Board Diff. Le Split de projet ordinaire est un double canevas PCB et schéma ; le Split Diff est Before et After. Si les réglages de comparaison ou les panneaux de résultats sont encombrés dans une fenêtre étroite, agrandissez la fenêtre pour les lire. Cette passe n’a pas vérifié la disposition Diff du shell étroite.

Liste d’acceptation

  • Un document avec une seule révision n’active pas Compare Revisions….
  • Deux révisions de bibliothèque de même format peuvent s’exécuter, et se rouvrir depuis Reopen Saved Comparison.
  • Une même entrée, des formats différents, des formats non pris en charge ou des bases SES incohérentes bloquent Compare avec une raison claire.
  • Les couches ambiguës doivent terminer l’appariement manuel avant de continuer.
  • La position de caméra reste cohérente lors du basculement Overlay / Split / Blink.
  • L’activation / désactivation de Sync Camera en Split se comporte correctement, et Fit rétablit une vue de toute la carte.
  • Added / Removed / Modified, le type d’objet, Net et les filtres de risque réduisent tous les résultats.
  • Les clics de liste, la sélection Viewer et Previous / Next peuvent localiser le même changement dans les deux directions.
  • Après Swap, la direction, les couleurs, les statistiques, les détails et les risques s’inversent correctement.
  • Après l’annulation d’une comparaison de grande carte en cours, la page attend le nettoyage et peut comparer à nouveau.
  • JSON et PNG s’exportent tous les deux, et les artefacts hébergés ne sont pas réutilisés à tort après un changement d’entrées.

Limites explicites actuelles

  • Seules des entrées de même format sont comparées ; la comparaison inter-formats n’est pas prise en charge.
  • ODB++, IPC-2581, PCB / bibliothèque Altium, projet KiCad complet, Diff de schéma et Diff 3D ne sont pas pris en charge.
  • Il n’y a pas de fusion automatique, d’acceptation de changement ni de modification inverse des fichiers source.
  • Il n’y a pas d’alignement automatique ; la translation et la rotation de la carte entière restent des différences visibles.
  • Les pixels d’image, le bbox ou le texte de fichier ne servent pas de repli pour un Diff géométrique exact.

FAQ

Pourquoi le bouton Compare est-il indisponible ?

Vérifiez que les deux côtés sont sélectionnés, que les contenus diffèrent et qu’ils s’analysent comme le même format pris en charge. Pour Gerber / Excellon, donnez à chaque côté le dossier ou l’archive du paquet complet ; deux fichiers de couche unique choisis au hasard ne peuvent pas représenter une carte complète.

Pourquoi la même extension signale-t-elle encore une incompatibilité de format ?

Le format est décidé par les résultats d’analyse réels, pas par le nom de fichier seul. Les répertoires, archives, conceptions de base SES et l’entrée de carte réelle participent tous à la validation.

Pourquoi ne puis-je pas comparer à nouveau immédiatement après une annulation ?

La page attend que PcbCore libère les deux sessions Before / After et les données temporaires, afin qu’une nouvelle tâche n’occupe pas les ressources en même temps qu’une ancienne. Réessayez après la disparition de Cancelling comparison….

Pourquoi les comptes de changements ou les risques ont-ils aussi changé après Swap ?

Added / Removed et les indices de risque sont directionnels. Swap n’échange pas seulement des libellés d’affichage ; il recalcule avec Before / After inversés.

Résultat

Après la comparaison, vous pouvez localiser les changements exacts des deux côtés dans le même espace de travail, contrôler les risques directionnels et exporter JSON / PNG. Les comparaisons de révisions de bibliothèque peuvent aussi être enregistrées et rouvertes après validation.

Dernière vérification

2026-07-30 (compte rendu de flux d’origine) ; 2026-09-11 a vérifié l’entrée bibliothèque et n’a pas relancé la comparaison.