ForHosting KIT · Outils pour développeurs

Calculateur de brillance de surface

Ce calculateur convertit la magnitude apparente intégrée et l’aire angulaire d’un objet étendu en brillance moyenne par seconde d’arc carrée.

● BetaGratuit · dans votre navigateur

Lancer gratuitement Voir l’API

Utilisez-le depuis WebAPIE-mailTelegramApp bientôt

Il convient aux galaxies, nébuleuses, comètes et autres sources occupant une région du ciel. Saisissez la magnitude totale mesurée dans une bande photométrique et l’aire correspondante en secondes d’arc carrées. Le résultat suit l’échelle logarithmique astronomique et reste associé à cette même bande.

Ce que révèle la brillance de surface

La magnitude totale rassemble toute la lumière reçue en une mesure, sans indiquer si elle provient d’un noyau compact ou d’une vaste région diffuse. La brillance de surface moyenne apporte cette information spatiale en répartissant la lumière intégrée sur l’aire angulaire apparente. Elle s’exprime en magnitudes par seconde d’arc carrée, souvent mag/arcsec². L’échelle des magnitudes étant inversée, une valeur numérique plus faible désigne une surface plus brillante, et une valeur plus élevée une surface plus faible. Deux galaxies de même magnitude totale peuvent donc être très différentes à observer : une galaxie compacte ressort nettement sur le ciel, tandis qu’une galaxie diffuse peut rester difficile à détecter. Le résultat est une moyenne sur l’aire fournie ; il ne décrit pas séparément le noyau, les bras spiraux ou le halo externe.

Principe du calcul

La formule appliquée est μ = m + 2.5 log₁₀(A), où μ est la brillance de surface moyenne, m la magnitude apparente intégrée et A l’aire angulaire en secondes d’arc carrées. Cette aire doit couvrir exactement la région utilisée pour mesurer la magnitude. À magnitude totale constante, une aire plus grande produit une valeur numérique plus élevée, donc une surface plus faible. Pour exactement une seconde d’arc carrée, la magnitude ne change pas. La magnitude peut être négative, nulle ou positive, à condition d’être finie. L’aire doit être finie et strictement positive, car le logarithme de zéro ou d’une valeur négative n’est pas défini ici. Le résultat est arrondi à six décimales. Aucune correction d’extinction, d’inclinaison, d’assombrissement cosmologique, de PSF ou de fond n’est ajoutée automatiquement.

Choisir une aire angulaire cohérente

La fiabilité dépend surtout d’une définition cohérente de la région mesurée. Utilisez l’aire de la même ouverture, isophote, carte de segmentation ou limite géométrique que celle employée pour obtenir la magnitude totale. Pour une ellipse dont a et b sont les diamètres complets, l’aire projetée vaut πab/4 ; s’il s’agit des demi-axes, elle vaut πab. Convertissez toujours en secondes d’arc carrées. Une minute d’arc carrée équivaut à 3,600 secondes d’arc carrées : oublier cette conversion modifie fortement le résultat. Conservez également la bande photométrique. Une magnitude V donne une brillance en V, tandis qu’une magnitude r donne une valeur en r. Avant de comparer des catalogues, vérifiez si leurs aires sont isophotales, effectives, d’ouverture ou issues d’un modèle. Mentionnez la région retenue afin que votre comparaison puisse être reproduite.

Cas d’usage

Comparer des galaxies diffuses

Distinguez les systèmes compacts et ceux à faible brillance de surface malgré des magnitudes intégrées voisines.

Évaluer une cible d’observation

Estimez si une nébuleuse ou une galaxie se détachera du fond du ciel avant de préparer l’observation.

Vérifier un calcul de catalogue

Recalculez une brillance publiée à partir de la magnitude et de l’aire d’ouverture indiquées.

Questions fréquentes

Quelle formule le calculateur emploie-t-il ?

Il utilise μ = m + 2.5 log₁₀(A), avec l’aire angulaire A exprimée en secondes d’arc carrées.

Pourquoi une magnitude supérieure indique-t-elle une surface plus faible ?

L’échelle astronomique est logarithmique et inversée : les grandes valeurs numériques correspondent à moins de flux.

Que se passe-t-il si l’aire est nulle ou négative ?

La requête renvoie une erreur de saisie, car le logarithme requis n’existe pas pour une aire non positive.

Le résultat corrige-t-il l’extinction ou l’assombrissement cosmologique ?

Non. Il utilise directement la magnitude et l’aire fournies ; appliquez séparément les corrections scientifiques nécessaires.

Quel est le prix d’un calcul par API ?

Chaque requête API coûte $0.002 ; la version navigateur exécute localement le même calcul déterministe.

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

POSThttps://api.kit.forhosting.com/astro/surface-brightness

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/astro/surface-brightness \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"total_magnitude":10.5,"angular_area_arcsec2":120}'

const res = await fetch("https://api.kit.forhosting.com/astro/surface-brightness", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "total_magnitude": 10.5,
    "angular_area_arcsec2": 120
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/astro/surface-brightness",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "total_magnitude": 10.5,
    "angular_area_arcsec2": 120
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/astro/surface-brightness", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"total_magnitude":10.5,"angular_area_arcsec2":120}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"total_magnitude":10.5,"angular_area_arcsec2":120}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/astro/surface-brightness", 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

{
  "total_magnitude": 10.5,
  "angular_area_arcsec2": 120
}

Exemple de réponse

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "astro.surface_brightness",
  "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

par requête$0.002

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.

Consulter la documentation complète du KIT →