Hydraulischer Gradient

Ein Null- oder Negativabstand wird mit invalid_input abgelehnt statt einer Division durch null.

Was i = (h1 − h2) / L bedeutet und welche Größen Sie senden müssen

Die Lieferung von head_1, head_2, distance, head_difference, hydraulic_gradient, dem kurzen Alias i, gradient_magnitude, formula, method und einem kleinen flow_from-Hinweis als JSON erleichtert das Einfügen ins Notizbuch, den Vergleich in automatisierten Tests und die Wiederverwendung über Sprachen hinweg, ohne Subtraktion und Division neu zu implementieren. Das Vorzeichen gehört zum Vertrag: ein positives i bedeutet, dass die Höhe von Punkt 1 zu Punkt 2 fällt, sodass Grundwasser in einem isotropen Medium von 1 nach 2 flösse; ein negatives i bedeutet das Gegenteil; ein Null-i heißt eine ebene Potenzialfläche zwischen den beiden Punkten.

Wie dieser Rechner Eingaben prüft und i = (h1 − h2) / L anwendet

Numerische Zeichenketten, die sich als endliche Zahlen lesen lassen, werden akzeptiert, damit Formulare und CSV-artige Pipelines Werte ohne extra Cast übergeben. Der Abstand muss streng positiv sein. Ein negativer Abstand wird aus demselben Grund abgelehnt: L ist eine geometrische Weglänge, kein vorzeichenbehafteter Koordinatensprung. Standrohrspiegelhöhen dürfen jeder endliche Wert sein, einschließlich Ablesungen unter einem gewählten Datum; eine negative Höhe ist in gespannten Grundwasserleitern, die auf Geländeoberkante bezogen sind, physikalisch üblich und gilt nicht als Fehler. Es gibt keine Einheitenumrechnungstabelle, keine hydraulische-Leitfähigkeits-Abfrage und keinen Finite-Differenzen-Grundwassersolver; das ist ideales eindimensionales i aus drei bekannten Größen. Senden Sie einen JSON-Körper mit drei Pflichtfeldern: head_1, head_2 und distance. Jedes Feld muss endlich sein: fehlende Felder, leere Zeichenketten, nichtnumerischer Text, NaN und Infinity scheitern sofort mit invalid_input, bevor ein Ergebnis zurückkommt, und eine fehlgeschlagene Prüfung wird nicht berechnet. Aliase sind unterstützt: h1, head1, hydraulic_head_1 für head_1; h2, head2, hydraulic_head_2 für head_2; L, length, dl für distance. Ein Nullabstand wird stets als invalid_input abgelehnt, weil das Teilen einer Höhendifferenz durch eine verschwindende Weglänge undefiniert ist und dieser Fehler der in der Produktkarte genannte Vertrag ist. Nach der Prüfung subtrahiert die Engine head_2 von head_1, teilt durch distance, nimmt den Absolutwert für gradient_magnitude und rundet auf eine stabile Dezimalgenauigkeit, damit dieselbe Eingabe über JavaScript-Engines stets dasselbe JSON ergibt. Ein sanftes flow_from-Kennzeichen hält die implizierte isotrope Richtung fest—1_to_2 wenn i positiv ist, 2_to_1 wenn i negativ ist und none wenn die Höhen gleich sind—nur als didaktische Bequemlichkeit; es ist kein dreidimensionales Strömungsnetz, keine Partikelbahn und kein Klassierer heterogener Aquifere. Dieselbe reine Funktion speist das kostenlose Browser-Werkzeug und den API-Pfad.

Praktischer Einsatz, Grenzen, Preis und Lieferkanäle

Verwenden Sie die API, wenn ein Skript, eine Unterrichtsplattform, eine Laborheft-Pipeline oder ein Entwässerungshelfer stabiles JSON für viele Höhe–Abstand-Tupel unter einem einzigen Vertrag braucht. Jede erfolgreiche Anfrage ist ein abrechenbares Item zu $0.002; fehlgeschlagene Validierung wird nicht berechnet. Ergebnisse sind vollständig deterministisch: dieselben drei Eingaben liefern stets dasselbe hydraulic_gradient, denselben Alias i, dasselbe gradient_magnitude und dieselben Formel- und Methodenbezeichnungen. Weil die Umsetzung reine Parse-Stufe A ist, kostet jeder erfolgreiche Aufruf den veröffentlichten Grundpreis $0.002 ohne Modell-Token und ohne ausgehendes Netz.