ForHosting KIT · Mathématiques

Distance point-plan

Le point (1, 1, 1) se trouve à quatre tiers, 1,333333333333, du plan 2x + y + 2z − 9 = 0. Saisissez les quatre coefficients du plan et un point pour obtenir l'écart minimal, son signe et si le point est sur le plan. Gratuit dans votre navigateur.

  • Gratuit
  • Fonctionne dans votre navigateur
  • Sans inscription
  • Vos données restent sur votre appareil
Utilisez-le depuis WebAPIE-mailTelegramApp bientôt
Si vous saisissez
A
2
B
1
C
2
D
-9
X
1
Y
1
Vous obtenez
Distance
1,3333333333
Distance algébrique
-1,3333333333
Norme
3

La distance perpendiculaire d'un point à un plan est le plus court chemin de ce point à n'importe quel endroit du plan infini. Vous en avez besoin lorsqu'un élève vérifie un devoir sur l'équation générale du plan, qu'un géomètre ou un opérateur CAO mesure le dégagement par rapport à un plan de sol ou de mur, qu'un pipeline de jeu ou de robotique maintient un acteur à l'écart d'une contrainte planaire, ou qu'une pile de vision artificielle signale le décalage par rapport à une surface ajustée. Cette capacité accepte les sept nombres a, b, c, d, x, y et z qui définissent le plan ax plus by plus cz plus d égal zéro et le point de requête, rejette le cas dégénéré où la normale du plan (a, b, c) est le vecteur nul, et renvoie la distance non négative avec la distance signée, la longueur de la normale et l'indication que le point est déjà sur le plan.

Ce qu'est la formule et comment les nombres fonctionnent

Écrivez le plan infini sous forme générale (cartésienne) comme a fois x plus b fois y plus c fois z plus d égal zéro. Le triplet (a, b, c) est un vecteur normal au plan : il pointe perpendiculairement à toute direction qui reste dans le plan. La longueur de cette normale est la norme euclidienne sqrt de a au carré plus b au carré plus c au carré.

Pour un point de requête (x, y, z), substituez les coordonnées dans le membre de gauche pour obtenir le résidu a fois x plus b fois y plus c fois z plus d. La valeur absolue de ce résidu divisée par la longueur de la normale est exactement la distance perpendiculaire du point au plan. Lorsque le résidu est zéro, le point satisfait l'équation du plan et la distance est zéro.

Un contrôle classique est le plan deux x plus y plus deux z moins neuf égal zéro (normale 2-1-2 de longueur trois) et le point (1, 1, 1) : valeur absolue du résidu quatre, norme trois, distance quatre tiers. Chaque étape est de l'arithmétique élémentaire et une racine carrée tridimensionnelle (ou hypot), donc il n'y a ni itération, ni échantillonnage, ni dépendance à l'horloge murale, ni besoin de conversion point-normale dans le contrat d'entrée une fois que vous détenez déjà a, b, c et d.

Dégagement et recul par rapport à un plan de sol, mur ou toiture

Mesurez à quelle distance une structure, une lecture de capteur ou un sommet de maillage se situe d'un plan de chantier ou de levé exprimé sous forme générale.

Décalage jeu, CAO et robotique depuis une contrainte planaire

Calculez le décalage latéral d'un personnage, d'une pièce ou d'un effecteur final par rapport à un plan infini utilisé comme contrainte de collision, de sol ou de guidage.

Quelle est la formule de la distance d'un point à un plan ?

La valeur absolue garantit une longueur non négative.

Qu'est-ce que la distance signée à un plan ?

La distance signée est (ax+by+cz+d)/sqrt(a²+b²+c²). Son signe indique dans quel demi-espace se trouve le point par rapport à la normale orientée (a,b,c) ; la magnitude correspond à la distance ordinaire.

Cela fonctionne-t-il pour un triangle ou une face bornée ?

Non. Cette capacité mesure la distance au plan infini. La plus courte distance à un polygone fini ou à une face de maillage exige une logique de clamp et est un autre problème.

Que se passe-t-il si les trois premiers coefficients valent zéro ?

Aucun plan n'existe alors : l'expression se réduit au seul terme constant. Le calculateur ne fournit pas de distance dans ce cas ; vérifiez qu'au moins un des trois premiers coefficients est non nul.

Comment savoir si un point appartient au plan ?

Sa distance vaut zéro et le résultat indique qu'il se trouve sur le plan. Cela arrive exactement quand ses coordonnées vérifient l'équation du plan, ce qui permet de contrôler un sommet de maillage ou un point mesuré.

Tout sur cette page est disponible par programmation. Cette section s'adresse aux équipes qui veulent l'intégrer à leurs systèmes ; les autres peuvent simplement utiliser l'outil ci-dessus.

POSThttps://api.kit.forhosting.com/geom/point-plane-distance

Authentification par jeton Bearer : un seul POST met la tâche en file d’attente, et le résultat vous parvient par webhook ou lien signé.

curl -X POST https://api.kit.forhosting.com/geom/point-plane-distance \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"a":2,"b":1,"c":2,"d":-9,"x":1,"y":1,"z":1}'
{
  "a": 2,
  "b": 1,
  "c": 2,
  "d": -9,
  "x": 1,
  "y": 1,
  "z": 1
}
{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "geom.point_plane_distance",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

L’API est asynchrone : chaque appel renvoie un task_id immédiatement, puis vous interrogez l’état à raison d’une requête par seconde.

par requête$0.002

Le prix est publié, sans tokens ni crédits. Une tâche qui échoue n’est pas facturée.

max_abs1000000000000
min_norm1e-15
HTTPCodeSignification
401unauthorizedClé API absente ou invalide : vérifiez l’en-tête Authorization.
402insufficient_balanceSolde insuffisant : rechargez votre compte pour lancer cette tâche.
404unknown_typeType de tâche inconnu : vérifiez le champ type de votre requête.
429rate_limitedTrop de requêtes : ralentissez la cadence, puis réessayez.

Les résultats sont du JSON déterministe—sans système de calcul formel, sans graines aléatoires, avec la même fonction pure de résolution dans l'outil gratuit du navigateur et sur le chemin API prépayé—, de sorte que les vérifications de devoirs, les scripts de notation et les pipelines de production voient toujours les mêmes nombres.

Ce qu'est la formule et comment les nombres fonctionnent

Lorsque a, b et c sont tous nuls, l'expression se réduit à la constante d et ne définit aucun plan—cet outil renvoie invalid_input au lieu d'inventer une distance. Un autre contrôle est tout point connu pour être sur le plan : la distance doit être zéro et on_plane vrai.

Comment appeler l'API et ce qui revient

Utilisez-le pour des pipelines de devoirs de géométrie de l'espace, des scripts de dégagement chantier, des outils de niveau de jeu, des sandboxes de préparation d'entretien, des contrôles d'exclusion robotique, ou tout flux nécessitant une distance point-plan reproductible sans installer un package d'algèbre formelle sur chaque machine. Envoyez un corps JSON avec sept champs numériques. Le champ a est le premier coefficient de la normale du plan ; les alias A et coeff_a sont acceptés. Le champ b est le second coefficient ; les alias B et coeff_b ont le même sens. Le champ c est le troisième coefficient ; les alias C et coeff_c sont acceptés. Le champ d est le terme constant ; les alias D et coeff_d fonctionnent. Le champ x est la première coordonnée du point ; les alias x0, px et point_x fonctionnent. Le champ y est la deuxième coordonnée ; les alias y0, py et point_y fonctionnent. Le champ z est la troisième coordonnée ; les alias z0, pz et point_z fonctionnent. En cas de succès, la réponse répète a, b, c, d, x, y et z, ajoute distance (non négative), signed_distance (positive ou négative selon le côté de la normale orientée où se trouve le point), on_plane (vrai lorsque la distance est zéro), norm (sqrt de a au carré plus b au carré plus c au carré), method égal à perpendicular, et un court bloc formula documentant les formes fermées. Une validation échouée—champ requis manquant, nombre non fini, valeur hors des limites absolues publiées, ou normale (a, b, c) entièrement nulle—renvoie invalid_input et n'est jamais facturée. Le tarif est un forfait de $0.002 par requête réussie avec unité item et prix marginal unitaire nul.

Conseils pratiques, limites et recherches associées

Si votre plan est donné par trois points non colinéaires, formez deux vecteurs d'arête, prenez leur produit vectoriel pour obtenir (a, b, c), puis fixez d de sorte qu'un des trois points satisfasse l'équation. En enseignement, préférez des exemples appariés : deux-un-deux-moins-neuf en (1,1,1) pour une distance de quatre tiers ; un point sur le plan pour une distance nulle ; et a égal b égal c égal zéro pour démontrer le rejet dur qui protège les appelants d'un non-plan. Cette page vise les personnes qui cherchent un calculateur de distance point à plan ou une distance perpendiculaire à ax plus by plus cz plus d égal zéro ; ce n'est pas un outil de distance à un triangle ni de découpage à un demi-espace—la plus courte distance à un patch polygonal fini exige une logique de clamp barycentrique hors de portée ici. Préférez cette capacité lorsque vous disposez déjà de la forme générale d'un plan infini en trois dimensions. Gardez coefficients et coordonnées dans la plage absolue publiée jusqu'à un billion afin que les produits intermédiaires restent finis en double précision IEEE sur le Worker et dans le navigateur. Les unités sont celles que vous passez—mètres, pieds ou unités de jeu—tant que a, b, c, d, x, y et z sont cohérents avec une seule unité de longueur pour le résultat de distance ; l'API ne convertit pas les unités pour vous. Comme la formule n'a besoin que de sept scalaires, les élèves peuvent recalculer à la main le résidu et le hypot avec de petits entiers et coller l'API ligne par ligne. Les tâches en échec qui renvoient invalid_input ne consomment pas le solde prépayé, ce qui maintient les scripts exploratoires peu coûteux lorsque les utilisateurs saisissent une normale nulle en apprenant le contrat. Les contrôles aller-retour sont simples : après résolution, confirmez que distance égale la valeur absolue de signed_distance, que on_plane est vrai exactement lorsque distance est zéro, et que norm au carré égale a au carré plus b au carré plus c au carré dans la tolérance flottante.

Vérifications de devoirs et d'examens sur la distance point-plan

Donnez aux élèves un plan ax+by+cz+d=0 et un point ; comparez leur distance perpendiculaire calculée à la main à un résultat déterministe de l'API ou du navigateur gratuit.

Pourquoi une normale de plan nulle est-elle rejetée ?

Si a=b=c=0 l'équation se réduit à d=0 ou à une contradiction et ne définit pas un plan. Cet outil renvoie invalid_input au lieu d'une distance dénuée de sens.

Le calculateur de distance point-plan est-il gratuit ?

L'outil navigateur est gratuit et s'exécute localement. Les appels API utilisent le solde prépayé KIT à $0.002 par requête réussie ; les tâches en échec ne sont jamais facturées.

Consulter la documentation complète du KIT →