Porosité par compaction des sédiments
Un sable de porosité initiale 0,5, enfoui à 2 km avec un coefficient de compaction de 0,5 par km, garde un peu plus de dix-huit pour cent de pores, soit un peu plus du tiers de sa valeur en surface. Gratuit dans votre navigateur.
- Gratuit
- Fonctionne dans votre navigateur
- Sans inscription
- Vos données restent sur votre appareil
Lancer gratuitement
Exemple résolu
- Porosité de surface
- 0,5
- Profondeur d'enfouissement
- 2
- Coefficient de compaction
- 0,5
- Porosité
- 0,1839397206
- Porosité (%)
- 18,3939720586
- Taux de compaction
- 0,3678794412
Lorsque les sédiments sont enfouis sous des dépôts plus jeunes, l'espace poral se réduit sous contrainte effective et diagénèse. Les modèles de bassin, la volumétrie de réservoir et le contrôle qualité des diagraphies ont besoin d'un moyen simple et reproductible d'estimer la porosité en profondeur à partir d'une valeur de surface et d'une tendance de compaction. La classique loi exponentielle de porosité–profondeur d'Athy exprime la porosité comme la porosité de surface multipliée par e à la puissance moins le coefficient de compaction fois la profondeur d'enfouissement. Ce calculateur de porosité par compaction des sédiments applique cette loi de façon déterministe : vous fournissez φ0 en fraction, la profondeur d'enfouissement z dans une unité de longueur cohérente et le coefficient de compaction c en inverse de longueur ; la réponse renvoie la porosité à cette profondeur, le pourcentage et le rapport résiduel φ/φ0. Un coefficient de compaction négatif est physiquement incompatible avec une compaction progressive et est rejeté comme entrée invalide.
Ce que signifie la loi exponentielle de porosité–profondeur
La relation exponentielle de porosité–profondeur de type Athy est le modèle de premier ordre de référence enseigné en géologie sédimentaire et utilisé comme tendance par défaut dans de nombreux workflows de bassins et de systèmes pétroliers. La porosité de surface φ0 est la fraction de vide dépositionnelle ou proche de la surface de la lithologie d'intérêt—typiquement de l'ordre de 0.4–0.5 pour des sables propres et plus élevée pour certaines roches argileuses avant une compaction significative.
Le coefficient de compaction c décrit la vitesse à laquelle cette porosité décroît avec la profondeur : un c plus grand signifie une réduction plus rapide de l'espace poral pour le même intervalle d'enfouissement. La profondeur d'enfouissement z doit partager l'unité de longueur implicite de c (par exemple des kilomètres lorsque c est exprimé par kilomètre, ou des mètres lorsque c est par mètre). En surface, z vaut zéro et l'exponentielle vaut un, de sorte que la porosité renvoie exactement φ0.
À mesure que la profondeur croît, exp(−c·z) tend vers zéro et la porosité asymptote vers zéro sous cette forme exponentielle pure. Le modèle est isotrope et unidimensionnel : il n'invente ni surpression, ni sauts de cimentation, ni troncatures d'inconformité. Ces processus comptent dans les bassins réels, mais se superposent à une tendance exponentielle de base ; ils ne justifient pas d'abandonner une formule de criblage transparente.
Ce calculateur n'applique que la ligne de base—φ(z) égale à φ0 fois exp(−c fois z)—afin que chaque client reproduise le même nombre à partir des mêmes trois scalaires. Lorsque vous avez besoin de valeurs de c spécifiques à la lithologie, prenez-les de votre calibration de puits ou de cartes régionales publiées et saisissez-les ici ; le point d'accès n'embarque pas de table secrète de coefficients.
La porosité de surface n'est acceptée que comme fraction sans dimension entre zéro et un inclus ; si vos diagraphies indiquent un pourcentage, divisez par cent avant d'appeler. La profondeur doit être non négative.
Quand estimer la porosité en profondeur
Les équipes d'exploration et de réservoir ont besoin d'estimations rapides de porosité en profondeur pour cribler des prospects, vérifier qu'une porosité dérivée des diagraphies est plausible pour un enfouissement donné, ou construire de simples profils unidimensionnels de compaction avant de lancer un modèle de bassin complet. Les pipelines de géomodélisation et les notebooks Jupyter peuvent appeler un petit point d'accès parse au lieu de réimplémenter exp et les cas limites dans chaque script, réduisant les erreurs silencieuses d'unités et les bogues de c négatif.
Les rapports publics et de conseil documentent souvent une tendance exponentielle à côté d'un puits ; automatiser ce calcul avec une chaîne de formule versionnée rend les annexes reproductibles. Une validation échouée ne consomme pas de solde. Gardez φ0 en fraction, figez les sorties arrondies dans les tests, et vous obtenez des nombres déterministes de porosité en profondeur pour l'enseignement, le QC et l'automatisation légère sans déployer une pile complète de géomécanique ou de modélisation de bassin.
Cas d’usage
Criblage de porosité pour prospects et puits
Estimez la porosité à l'enfouissement cible à partir d'un φ0 de surface et d'un coefficient régional de compaction avant de comparer aux mesures de diagraphie ou de carotte.
Enseignement et travaux pratiques
Laissez les étudiants appliquer la loi exponentielle d'Athy pour des φ0, c et z arbitraires et vérifier qu'un c négatif est rejeté comme entrée invalide.
Questions fréquentes
Que se passe-t-il si le coefficient de compaction est négatif ?
Un c négatif ferait croître la porosité avec l'enfouissement sous cette loi ; cela est rejeté et non facturé.
La porosité de surface doit-elle être une fraction ou un pourcentage ?
Utilisez une fraction sans dimension entre 0 et 1 (par exemple 0.45 pour 45 %).
Quelles unités pour la profondeur et le coefficient ?
Le même système de longueur pour les deux. Saisissez la profondeur en kilomètres si le coefficient est par kilomètre, ou en mètres s’il est par mètre. Les mélanger fausse l’exposant et donne une porosité sans signification.
Où trouver un coefficient de compaction ?
Dans l’étalonnage de vos propres puits ou dans des abaques régionaux publiés pour la lithologie. Un coefficient plus élevé signifie que les pores disparaissent plus vite avec l’enfouissement ; le calculateur ne contient aucune table de valeurs.
Le calcul tient-il compte de la surpression ou de la cimentation ?
Non. Il applique seulement la tendance exponentielle de base, unidimensionnelle, sans surpression, cimentation ni discordances. Ces effets comptent dans les bassins réels et doivent s’ajouter à cette estimation de premier tri.
Outils associés
Pour les développeurs — accès API
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.
Endpoint
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é.
Appeler depuis votre stack
curl -X POST https://api.kit.forhosting.com/earth/sediment-compaction \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"surface_porosity":0.5,"burial_depth":2,"compaction_coefficient":0.5}'const res = await fetch("https://api.kit.forhosting.com/earth/sediment-compaction", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"surface_porosity": 0.5,
"burial_depth": 2,
"compaction_coefficient": 0.5
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/earth/sediment-compaction",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"surface_porosity": 0.5,
"burial_depth": 2,
"compaction_coefficient": 0.5
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/earth/sediment-compaction", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"surface_porosity":0.5,"burial_depth":2,"compaction_coefficient":0.5}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"surface_porosity":0.5,"burial_depth":2,"compaction_coefficient":0.5}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/earth/sediment-compaction", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)Exemple de requête
{
"surface_porosity": 0.5,
"burial_depth": 2,
"compaction_coefficient": 0.5
}Exemple de réponse
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "earth.sediment_compaction",
"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.
Tarifs
Le prix est publié, sans tokens ni crédits. Une tâche qui échoue n’est pas facturée.
Erreurs
| HTTP | Code | Signification |
|---|---|---|
401 | unauthorized | Clé API absente ou invalide : vérifiez l’en-tête Authorization. |
402 | insufficient_balance | Solde insuffisant : rechargez votre compte pour lancer cette tâche. |
404 | unknown_type | Type de tâche inconnu : vérifiez le champ type de votre requête. |
429 | rate_limited | Trop de requêtes : ralentissez la cadence, puis réessayez. |
Notes techniques
Ce que signifie la loi exponentielle de porosité–profondeur
Le coefficient de compaction doit être fini et non négatif : un c négatif ferait croître la porosité avec l'enfouissement, ce que cette loi rejette en invalid_input plutôt que de renvoyer une hausse trompeuse.
Contrat d'entrée, forme de la réponse et erreurs
La porosité de surface doit se situer dans l'intervalle fermé de zéro à un. La profondeur d'enfouissement doit être supérieure ou égale à zéro. Le coefficient de compaction doit être supérieur ou égal à zéro ; les valeurs négatives produisent un message clair indiquant que le coefficient ne peut pas être négatif et ne sont pas facturées. Les unités ne sont pas converties dans le gestionnaire : choisissez un système cohérent pour z et c et conservez-le pour tout le projet afin que les chiffres de criblage restent comparables entre puits et cartes. Envoyez en POST un corps JSON avec trois nombres finis obligatoires : surface_porosity (alias phi0, phi_0, porosity0, initial_porosity, phi_surface), burial_depth (alias depth, z, depth_km, burial_z) et compaction_coefficient (alias c, k, compaction_c, beta, compact_coeff). Chaque champ peut arriver comme nombre JSON ou comme chaîne numérique ; champs manquants, chaînes vides et valeurs non finies échouent avec invalid_input en nommant le champ. En cas de succès le corps renvoie les trois entrées arrondies à douze décimales pour des goldens stables, puis porosity (fraction en profondeur), porosity_percent (fraction fois cent), compaction_ratio (porosité divisée par la porosité de surface, ou un lorsque la surface est nulle) et une courte chaîne de formule reprenant la loi d'Athy. Exemple : surface_porosity 0.5, burial_depth 2, compaction_coefficient 0.5 donne une porosité égale à 0.5 fois e à la moins un, environ 0.1839, avec porosity_percent environ 18.39 et compaction_ratio environ 0.3679. Exemple : à burial_depth zéro la porosité égale surface_porosity pour tout c non négatif. Associez la réponse à votre propre code de tracé si vous avez besoin d'un profil continu en profondeur ; ce point d'accès évalue une seule profondeur par appel et n'émet ni grilles ni courbes de puits.
Où une API de porosité par compaction apporte de la valeur
Les laboratoires universitaires et les stages courts qui se positionnent sur le calculateur de porosité par compaction des sédiments bénéficient d'un outil gratuit dans le navigateur dont les réponses correspondent octet par octet à l'API payante pour les devoirs et les rapports de TP. Comme l'implémentation est purement parse de niveau A, chaque appel réussi coûte le prix de base publié $0.002 sans jetons de modèle ni réseau sortant.
Cas d'intégration
Baselines pour notebooks et pipelines
Appelez une API déterministe depuis des scripts de criblage de bassins afin que chaque exécution utilise le même contrat φ(z)=φ0·exp(−c·z) et le même arrondi.
Questions techniques
Comment la porosité à la profondeur d'enfouissement est-elle calculée ?
Envoyez surface_porosity (fraction dans [0,1]), burial_depth (≥0) et compaction_coefficient (≥0). L'API renvoie φ(z)=φ0·exp(−c·z) comme porosity, plus porosity_percent et compaction_ratio.
Quelles unités pour la profondeur d'enfouissement et c ?
Tout système de longueur cohérent : si c est en 1/km, donnez burial_depth en km ; si c est en 1/m, donnez la profondeur en m. Le gestionnaire ne convertit pas les unités.
Combien coûte le calculateur de porosité par compaction des sédiments ?
L'outil navigateur est gratuit. Les requêtes API utilisent le solde prépayé KIT à $0.002 par appel réussi ; une entrée invalide n'est pas facturée.