BlackHoletype
One black hole. Positions are J2000 (equator and equinox of 2000), the same frame as Star and DeepSkyObject.
Import it
import type { BlackHole } from "@johnmorrisdotca/hoshi-stars/black-holes";
Definition
interface BlackHole {
id: string;
name: string;
otherNames: string[];
kind: BlackHoleKind;
status: "confirmed" | "candidate";
constellation: string;
rightAscension: number;
declination: number;
massSuns: BlackHoleMeasure | undefined;
distanceParsecs: BlackHoleMeasure | undefined;
companion: string | undefined;
companionType: string | undefined;
foundBy: BlackHoleFound;
year: number | undefined;
sources: BlackHoleSources;
note: string | undefined;
}
Members
| Name | Type | Description |
|---|---|---|
id | string | A short unique id made of lower-case letters, digits and hyphens ( |
name | string | The name: the object's usual name ( |
otherNames | string[] | Other names that |
kind | "stellar" | "quiet" | "supermassive" | The kind: |
status | "confirmed" | "candidate" |
|
constellation | string | The IAU three-letter constellation abbreviation ( |
rightAscension | number | Right ascension in degrees at J2000, 0 up to 360. Given to 0.0001 degree (0.36 arc-second). |
declination | number | Declination in degrees at J2000, -90 to 90. Given to 0.0001 degree. |
massSuns | BlackHoleMeasure | undefined | The mass in Suns (solar masses) with its range, or |
distanceParsecs | BlackHoleMeasure | undefined | The distance in parsecs (1 parsec is 3.2616 light-years) with its range, or |
companion | string | undefined | The companion star's designation ( |
companionType | string | undefined | The companion star's spectral type or kind ( |
foundBy | "image" | "x-rays" | "orbit" | "microlensing" | "stars" | "gas" | "masers" | "echoes" | How it was found. |
year | number | undefined | The year: for a stellar black hole when its X-ray source was discovered, for a quiet one the year of its discovery paper, for a supermassive one the year of the mass measurement used. |
sources | BlackHoleSources | The papers behind each fact. |
note | string | undefined | A short English note where the facts need one (a disputed mass, an unusual place), else |
Examples
import { blackHole, type BlackHole } from "@johnmorrisdotca/hoshi-stars/black-holes";
const cygnus: BlackHole = blackHole("Cygnus X-1")!;
console.log(cygnus.id, cygnus.kind, cygnus.massSuns?.value, cygnus.companion, cygnus.year);cygnus-x-1 stellar 21.2 HDE 226868 1964What it prints (run when this page was built)