starplot 0.20.5__py3-none-any.whl

starplot/data/ecliptic.py

@@ -0,0 +1,201 @@
+ANGLE = 23.4
+
+RA_DECS = [
+    (0.0, 0.0),
+    (23.8875, -0.732),
+    (23.775, -1.4634),
+    (23.6625, -2.1934),
+    (23.5497, -2.9216),
+    (23.4369, -3.6472),
+    (23.3242, -4.3696),
+    (23.2108, -5.0881),
+    (23.0975, -5.8021),
+    (22.9839, -6.511),
+    (22.8697, -7.2141),
+    (22.7553, -7.9108),
+    (22.6406, -8.6003),
+    (22.5256, -9.2821),
+    (22.4097, -9.9555),
+    (22.2939, -10.6199),
+    (22.1772, -11.2745),
+    (22.06, -11.9188),
+    (21.9425, -12.552),
+    (21.8242, -13.1735),
+    (21.7053, -13.7827),
+    (21.5858, -14.3788),
+    (21.4658, -14.9614),
+    (21.3453, -15.5295),
+    (21.2239, -16.0828),
+    (21.1017, -16.6204),
+    (20.9792, -17.1418),
+    (20.8558, -17.6463),
+    (20.7317, -18.1334),
+    (20.6069, -18.6023),
+    (20.4817, -19.0525),
+    (20.3556, -19.4835),
+    (20.2289, -19.8946),
+    (20.1014, -20.2853),
+    (19.9733, -20.655),
+    (19.845, -21.0032),
+    (19.7158, -21.3295),
+    (19.5861, -21.6334),
+    (19.4558, -21.9144),
+    (19.325, -22.1721),
+    (19.1939, -22.4061),
+    (19.0622, -22.6161),
+    (18.9303, -22.8017),
+    (18.7981, -22.9627),
+    (18.6656, -23.0989),
+    (18.5328, -23.2099),
+    (18.3997, -23.2956),
+    (18.2664, -23.3559),
+    (18.1331, -23.3908),
+    (18.0, -23.4),
+    (17.8667, -23.3908),
+    (17.7333, -23.3559),
+    (17.6, -23.2956),
+    (17.4669, -23.2099),
+    (17.3342, -23.0989),
+    (17.2017, -22.9627),
+    (17.0694, -22.8017),
+    (16.9375, -22.6161),
+    (16.8058, -22.4061),
+    (16.6747, -22.1721),
+    (16.5439, -21.9144),
+    (16.4136, -21.6334),
+    (16.2839, -21.3295),
+    (16.1547, -21.0032),
+    (16.0264, -20.655),
+    (15.8983, -20.2853),
+    (15.7708, -19.8946),
+    (15.6442, -19.4835),
+    (15.5181, -19.0525),
+    (15.3928, -18.6023),
+    (15.2681, -18.1334),
+    (15.1439, -17.6463),
+    (15.0206, -17.1418),
+    (14.8981, -16.6204),
+    (14.7758, -16.0828),
+    (14.6544, -15.5295),
+    (14.5339, -14.9614),
+    (14.4139, -14.3788),
+    (14.2944, -13.7827),
+    (14.1756, -13.1735),
+    (14.0572, -12.552),
+    (13.9397, -11.9188),
+    (13.8225, -11.2745),
+    (13.7058, -10.6199),
+    (13.59, -9.9555),
+    (13.4742, -9.2821),
+    (13.3592, -8.6003),
+    (13.2444, -7.9108),
+    (13.13, -7.2141),
+    (13.0158, -6.511),
+    (12.9022, -5.8021),
+    (12.7889, -5.0881),
+    (12.6756, -4.3696),
+    (12.5628, -3.6472),
+    (12.45, -2.9216),
+    (12.3372, -2.1934),
+    (12.2247, -1.4634),
+    (12.1122, -0.732),
+    (12.0, 0.0),
+    (11.8875, 0.732),
+    (11.775, 1.4634),
+    (11.6625, 2.1934),
+    (11.5497, 2.9216),
+    (11.4369, 3.6472),
+    (11.3242, 4.3696),
+    (11.2108, 5.0881),
+    (11.0975, 5.8021),
+    (10.9839, 6.511),
+    (10.8697, 7.2141),
+    (10.7553, 7.9108),
+    (10.6406, 8.6003),
+    (10.5256, 9.2821),
+    (10.4097, 9.9555),
+    (10.2939, 10.6199),
+    (10.1772, 11.2745),
+    (10.06, 11.9188),
+    (9.9425, 12.552),
+    (9.8242, 13.1735),
+    (9.7053, 13.7827),
+    (9.5858, 14.3788),
+    (9.4658, 14.9614),
+    (9.3453, 15.5295),
+    (9.2239, 16.0828),
+    (9.1017, 16.6204),
+    (8.9792, 17.1418),
+    (8.8558, 17.6463),
+    (8.7317, 18.1334),
+    (8.6069, 18.6023),
+    (8.4817, 19.0525),
+    (8.3556, 19.4835),
+    (8.2289, 19.8946),
+    (8.1014, 20.2853),
+    (7.9733, 20.655),
+    (7.845, 21.0032),
+    (7.7158, 21.3295),
+    (7.5861, 21.6334),
+    (7.4558, 21.9144),
+    (7.325, 22.1721),
+    (7.1939, 22.4061),
+    (7.0622, 22.6161),
+    (6.9303, 22.8017),
+    (6.7981, 22.9627),
+    (6.6656, 23.0989),
+    (6.5328, 23.2099),
+    (6.3997, 23.2956),
+    (6.2664, 23.3559),
+    (6.1331, 23.3908),
+    (6.0, 23.4),
+    (5.8667, 23.3908),
+    (5.7333, 23.3559),
+    (5.6, 23.2956),
+    (5.4669, 23.2099),
+    (5.3342, 23.0989),
+    (5.2017, 22.9627),
+    (5.0694, 22.8017),
+    (4.9375, 22.6161),
+    (4.8058, 22.4061),
+    (4.6747, 22.1721),
+    (4.5439, 21.9144),
+    (4.4136, 21.6334),
+    (4.2839, 21.3295),
+    (4.1547, 21.0032),
+    (4.0264, 20.655),
+    (3.8983, 20.2853),
+    (3.7708, 19.8946),
+    (3.6442, 19.4835),
+    (3.5181, 19.0525),
+    (3.3928, 18.6023),
+    (3.2681, 18.1334),
+    (3.1439, 17.6463),
+    (3.0206, 17.1418),
+    (2.8981, 16.6204),
+    (2.7758, 16.0828),
+    (2.6544, 15.5295),
+    (2.5339, 14.9614),
+    (2.4139, 14.3788),
+    (2.2944, 13.7827),
+    (2.1756, 13.1735),
+    (2.0572, 12.552),
+    (1.9397, 11.9188),
+    (1.8225, 11.2745),
+    (1.7058, 10.6199),
+    (1.59, 9.9555),
+    (1.4742, 9.2821),
+    (1.3592, 8.6003),
+    (1.2444, 7.9108),
+    (1.13, 7.2141),
+    (1.0158, 6.511),
+    (0.9022, 5.8021),
+    (0.7889, 5.0881),
+    (0.6756, 4.3696),
+    (0.5628, 3.6472),
+    (0.45, 2.9216),
+    (0.3372, 2.1934),
+    (0.2247, 1.4634),
+    (0.1122, 0.732),
+    (0.0, 0.0),
+]

starplot/data/library/readme.md

@@ -0,0 +1 @@
+this directory only exists until all data from sky.db is deprecated

starplot/data/stars.py

@@ -0,0 +1,79 @@
+from functools import cache
+from pathlib import Path
+
+from ibis import _
+from shapely import Polygon, MultiPolygon
+
+from starplot.config import settings
+from starplot.data import db
+from starplot.data.catalogs import Catalog, SpatialQueryMethod, BIG_SKY_MAG11
+from starplot.data.translations import language_name_column, LANGUAGE_NAME_COLUMNS
+
+
+@cache
+def table(
+    con,
+    catalog: Catalog | Path | str = BIG_SKY_MAG11,
+    table_name="stars",
+    language: str = "en-us",
+):
+    if isinstance(catalog, Catalog):
+        stars = catalog._load(connection=con, table_name=table_name)
+    else:
+        stars = con.read_parquet(str(catalog), table_name=table_name)
+
+    designation_columns = ["name", "bayer", "flamsteed"] + LANGUAGE_NAME_COLUMNS
+    designation_columns_missing = {
+        col for col in designation_columns if col not in stars.columns
+    }
+
+    if designation_columns_missing and "hip" in stars.columns:
+        designations = con.table("star_designations")
+        designations = designations.mutate(
+            name=getattr(designations, language_name_column(language))
+        )
+        stars_joined = stars.join(
+            designations,
+            stars.hip == designations.hip,
+            how="left",
+        )
+        stars = stars_joined.select(*stars.columns, *designation_columns_missing)
+
+    return stars
+
+
+def load(
+    catalog: Catalog | Path | str,
+    extent: Polygon | MultiPolygon = None,
+    filters=None,
+    sql=None,
+):
+    filters = filters or []
+    con = db.connect()
+    stars = table(con=con, catalog=catalog, language=settings.language)
+
+    if (
+        catalog.spatial_query_method == SpatialQueryMethod.HEALPIX.value
+        and catalog.healpix_nside
+        and extent is not None
+    ):
+        healpix_indices = catalog.healpix_ids_from_extent(extent)
+        stars = stars.filter(stars.healpix_index.isin(healpix_indices))
+        stars = con.create_table("stars_temp", obj=stars, temp=True, overwrite=True)
+
+    stars = stars.mutate(
+        geometry=_.geometry.cast("geometry"),  # cast WKB to geometry type
+    )
+
+    if extent:
+        stars = stars.filter(stars.geometry.intersects(extent))
+
+    if filters:
+        stars = stars.filter(*filters)
+
+    if sql:
+        result = stars.alias("_").sql(sql).select("pk").execute()
+        pks = result["pk"].to_list()
+        stars = stars.filter(_.pk.isin(pks))
+
+    return stars

starplot/data/translations.py

@@ -0,0 +1,408 @@
+LABELS = {
+    "en-us": {
+        "legend": "legend",
+        "star magnitude": "star magnitude",
+        "star": "star",
+        "deep sky object": "deep sky object",
+        "open cluster": "open cluster",
+        "globular cluster": "globular cluster",
+        "nebula": "nebula",
+        "galaxy": "galaxy",
+        "dark nebula": "dark nebula",
+        "association of stars": "association of stars",
+        "double star": "double star",
+        "emission nebula": "emission nebula",
+        "galaxy pair": "galaxy pair",
+        "galaxy triplet": "galaxy triplet",
+        "galaxy cluster": "galaxy cluster",
+        "group of galaxies": "group of galaxies",
+        "hii ionized region": "hii ionized region",
+        "nova star": "nova star",
+        "planetary nebula": "planetary nebula",
+        "reflection nebula": "reflection nebula",
+        "star cluster nebula": "star cluster nebula",
+        "supernova remnant": "supernova remnant",
+        "unknown": "unknown",
+        "planet": "planet",
+        "mercury": "mercury",
+        "venus": "venus",
+        "mars": "mars",
+        "jupiter": "jupiter",
+        "saturn": "saturn",
+        "uranus": "uranus",
+        "neptune": "neptune",
+        "pluto": "pluto",
+        "sun": "sun",
+        "moon": "moon",
+        "north": "north",
+        "east": "east",
+        "south": "south",
+        "west": "west",
+        "ecliptic": "ecliptic",
+        "celestial equator": "celestial equator",
+        "n": "n",
+        "e": "e",
+        "s": "s",
+        "w": "w",
+        "milky way": "milky way",
+    },
+    "es": {
+        "star": "estrella",
+        "deep sky object": "objeto de cielo profundo",
+        "open cluster": "cúmulo abierto",
+        "globular cluster": "cúmulo globular",
+        "nebula": "nebulosa",
+        "galaxy": "galaxia",
+        "dark nebula": "nebulosa oscura",
+        "association of stars": "asociación estelar",
+        "double star": "estrella doble",
+        "emission nebula": "nebulosa de emisión",
+        "galaxy pair": "galaxia doble",
+        "galaxy triplet": "galaxia triple",
+        "galaxy cluster": "cúmulo de galaxias",
+        "group of galaxies": "grupo de galaxias",
+        "hii ionized region": "región ionizada hii",
+        "nova star": "estrella nova",
+        "planetary nebula": "nebulosa planetaria",
+        "reflection nebula": "nebulosa de reflexión",
+        "star cluster nebula": "nebulosa de cúmulo abierto",
+        "supernova remnant": "remanente de supernova",
+        "unknown": "desconocido",
+        "mercury": "mercurio",
+        "venus": "venus",
+        "mars": "marte",
+        "jupiter": "júpiter",
+        "saturn": "saturno",
+        "uranus": "urano",
+        "neptune": "neptuno",
+        "pluto": "plutón",
+        "sun": "sol",
+        "moon": "luna",
+        "north": "norte",
+        "east": "este",
+        "south": "sur",
+        "west": "oeste",
+        "ecliptic": "eclíptica",
+        "celestial equator": "ecuador celeste",
+        "n": "n",
+        "e": "e",
+        "s": "s",
+        "w": "o",
+        "milky way": "vía láctea",
+    },
+    "fr": {
+        "legend": "légende",
+        "star magnitude": "magnitude des étoiles",
+        "star": "étoile",
+        "deep sky object": "objet du ciel profond",
+        "open cluster": "amas ouvert",
+        "globular cluster": "amas globulaire",
+        "nebula": "nébuleuse",
+        "galaxy": "galaxie",
+        "dark nebula": "nébuleuse obscure",
+        "association of stars": "amas d'étoiles",
+        "double star": "étoile double",
+        "emission nebula": "nébuleuse en émission",
+        "galaxy pair": "paire de galaxies",
+        "galaxy triplet": "triplet de galaxies",
+        "galaxy cluster": "amas de galaxies",
+        "group of galaxies": "groupes de galaxies",
+        "hii ionized region": "région d'hydrogène ionisé",
+        "nova star": "nova",
+        "planetary nebula": "nébuleuse planétaire",
+        "reflection nebula": "nébuleuse par réflexion",
+        "star cluster nebula": "nébuleuse d’amas d’étoiles",
+        "supernova remnant": "rémanent de supernova",
+        "unknown": "inconnu",
+        "planet": "planète",
+        "mercury": "mercure",
+        "venus": "venus",
+        "mars": "mars",
+        "jupiter": "jupiter",
+        "saturn": "saturne",
+        "uranus": "uranus",
+        "neptune": "neptune",
+        "pluto": "pluton",
+        "sun": "soleil",
+        "moon": "lune",
+        "north": "nord",
+        "east": "est",
+        "south": "sud",
+        "west": "ouest",
+        "ecliptic": "écliptique",
+        "celestial equator": "équateur céleste",
+        "n": "n",
+        "e": "e",
+        "s": "s",
+        "w": "o",
+        "milky way": "voie lactée",
+    },
+    "it": {
+        "legend": "legenda",
+        "star magnitude": "magnitudine stellare",
+        "star": "stella",
+        "deep sky object": "oggetto del profondo cielo",
+        "open cluster": "ammasso aperto",
+        "globular cluster": "ammasso globulare",
+        "nebula": "nebulosa",
+        "galaxy": "galassia",
+        "dark nebula": "nebulosa oscura",
+        "association of stars": "ammasso stellare",
+        "double star": "stella doppia",
+        "emission nebula": "nebulosa a emissione",
+        "galaxy pair": "coppia di galassie",
+        "galaxy triplet": "trio di galassie",
+        "galaxy cluster": "ammasso di galassie",
+        "group of galaxies": "gruppo di galassie",
+        "hii ionized region": "regione hii",
+        "nova star": "nova",
+        "planetary nebula": "nebulosa planetaria",
+        "reflection nebula": "nebulosa a riflessione",
+        "star cluster nebula": "nebulosa di ammasso stellare",
+        "supernova remnant": "resto di supernova",
+        "unknown": "sconosciuto",
+        "planet": "pianeta",
+        "mercury": "mercurio",
+        "venus": "venere",
+        "mars": "marte",
+        "jupiter": "giove",
+        "saturn": "saturno",
+        "uranus": "urano",
+        "neptune": "nettuno",
+        "pluto": "plutone",
+        "sun": "sole",
+        "moon": "luna",
+        "north": "nord",
+        "east": "est",
+        "south": "sud",
+        "west": "ovest",
+        "ecliptic": "eclittica",
+        "celestial equator": "equatore celeste",
+        "n": "n",
+        "e": "e",
+        "s": "s",
+        "w": "o",
+        "milky way": "via lattea",
+    },
+    "zh-cn": {
+        "legend": "图例",
+        "star magnitude": "星等",
+        "star": "恒星",
+        "deep sky object": "深空天体",
+        "open cluster": "疏散星团",
+        "globular cluster": "球状星团",
+        "nebula": "星云",
+        "galaxy": "星系",
+        "dark nebula": "暗星云",
+        "association of stars": "星协",
+        "double star": "双星",
+        "emission nebula": "发射星云",
+        "galaxy pair": "星系对",
+        "galaxy triplet": "三重星系",
+        "galaxy cluster": "星系团",
+        "group of galaxies": "星系群",
+        "hii ionized region": "hii电离氢区",
+        "nova star": "新星",
+        "planetary nebula": "行星状星云",
+        "reflection nebula": "反射星云",
+        "star cluster nebula": "星团星云",
+        "supernova remnant": "超新星遗迹",
+        "unknown": "未知天体",
+        "planet": "行星",
+        "mercury": "水星",
+        "venus": "金星",
+        "mars": "火星",
+        "jupiter": "木星",
+        "saturn": "土星",
+        "uranus": "天王星",
+        "neptune": "海王星",
+        "pluto": "冥王星",
+        "sun": "太阳",
+        "moon": "月球",
+        "north": "北",
+        "east": "东",
+        "south": "南",
+        "west": "西",
+        "ecliptic": "黄道",
+        "celestial equator": "天赤道",
+        "n": "北",
+        "e": "东",
+        "s": "南",
+        "w": "西",
+        "milky way": "银河",
+    },
+    "zh-tw": {
+        "legend": "圖例",
+        "star magnitude": "星等",
+        "star": "恆星",
+        "deep sky object": "深空天體",
+        "open cluster": "疏散星團",
+        "globular cluster": "球狀星團",
+        "nebula": "星雲",
+        "galaxy": "星系",
+        "dark nebula": "暗星雲",
+        "association of stars": "星協",
+        "double star": "雙星",
+        "emission nebula": "發射星雲",
+        "galaxy pair": "星系對",
+        "galaxy triplet": "三重星系",
+        "galaxy cluster": "星系團",
+        "group of galaxies": "星系群",
+        "hii ionized region": "hii電離氫區",
+        "nova star": "新星",
+        "planetary nebula": "行星狀星雲",
+        "reflection nebula": "反射星雲",
+        "star cluster nebula": "星團星雲",
+        "supernova remnant": "超新星遺蹟",
+        "unknown": "未知天體",
+        "planet": "行星",
+        "mercury": "水星",
+        "venus": "金星",
+        "mars": "火星",
+        "jupiter": "木星",
+        "saturn": "土星",
+        "uranus": "天王星",
+        "neptune": "海王星",
+        "pluto": "冥王星",
+        "sun": "太陽",
+        "moon": "月球",
+        "north": "北",
+        "east": "東",
+        "south": "南",
+        "west": "西",
+        "ecliptic": "黃道",
+        "celestial equator": "天赤道",
+        "n": "北",
+        "e": "東",
+        "s": "南",
+        "w": "西",
+        "milky way": "銀河",
+    },
+    "fa": {
+        "legend": "راهنما",
+        "star magnitude": "قدر ستاره",
+        "star": "ستاره",
+        "deep sky object": "جرم عمیق آسمانی",
+        "open cluster": "خوشه باز",
+        "globular cluster": "خوشه کروی",
+        "nebula": "سحابی",
+        "galaxy": "کهکشان",
+        "dark nebula": "سحابی تاریک",
+        "association of stars": "انجمن ستارگان",
+        "double star": "ستاره دوتایی",
+        "emission nebula": "سحابی گسیلی",
+        "galaxy pair": "جفت کهکشان",
+        "galaxy triplet": "سه‌گانه کهکشانی",
+        "galaxy cluster": "خوشه کهکشانی",
+        "group of galaxies": "گروه کهکشان‌ها",
+        "hii ionized region": "ناحیه یونیزه هیدروژن",
+        "nova star": "ستاره نوا",
+        "planetary nebula": "سحابی سیاره‌ای",
+        "reflection nebula": "سحابی بازتابی",
+        "star cluster nebula": "سحابی خوشه ستاره‌ای",
+        "supernova remnant": "بقایای ابرنواختر",
+        "unknown": "ناشناخته",
+        "planet": "سیاره",
+        "mercury": "تیر",
+        "venus": "ناهید",
+        "mars": "بهرام",
+        "jupiter": "مشتری",
+        "saturn": "کیوان",
+        "uranus": "اورانوس",
+        "neptune": "نپتون",
+        "pluto": "پلوتون",
+        "sun": "خورشید",
+        "moon": "ماه",
+        "north": "شمال",
+        "east": "شرق",
+        "south": "جنوب",
+        "west": "غرب",
+        "ecliptic": "دایره البروج",
+        "celestial equator": "استوای آسمانی",
+        "n": "ش",
+        "e": "ق",
+        "s": "ج",
+        "w": "غ",
+        "milky way": "کهکشان راه شیری",
+    },
+    "lt": {
+        "legend": "legenda",
+        "star": "žvaigždė",
+        "deep sky object": "tolimojo kosmoso objektas",
+        "open cluster": "padrikasis spiečius",
+        "globular cluster": "kamuolinis spiečius",
+        "nebula": "ūkas",
+        "galaxy": "galaktika",
+        "dark nebula": "tamsusis ūkas",
+        "association of stars": "žvaigždžių asociacija",
+        "double star": "dvinarė žvaigždė",
+        "emission nebula": "emisinis ūkas",
+        "galaxy pair": "galaktikų pora",
+        "galaxy triplet": "galaktikų trejetas",
+        "galaxy cluster": "galaktikų spiečius",
+        "group of galaxies": "galaktikų grupė",
+        "hii ionized region": "hii jonizuotas regionas",
+        "nova star": "nova (žvaigždė)",
+        "planetary nebula": "planetinis ūkas",
+        "reflection nebula": "atspindžio ūkas",
+        "star cluster nebula": "žvaigždžių spiečiaus ūkas",
+        "supernova remnant": "supernovos liekana",
+        "unknown": "nežinomas",
+        "mercury": "Merkurijus",
+        "venus": "Venera",
+        "mars": "Marsas",
+        "jupiter": "Jupiteris",
+        "saturn": "Saturnas",
+        "uranus": "Uranas",
+        "neptune": "Neptūnas",
+        "pluto": "Plutonas",
+        "sun": "Saulė",
+        "moon": "Mėnulis",
+        "north": "Šiaurė",
+        "east": "Rytai",
+        "south": "Pietūs",
+        "west": "Vakarai",
+        "ecliptic": "Ekliptika",
+        "celestial equator": "Dangaus pusiaujas",
+        "n": "Š",
+        "e": "R",
+        "s": "P",
+        "w": "V",
+        "milky way": "Paukščių Takas",
+    },
+}
+
+
+LANGUAGES = [
+    "en-us",
+    "es",
+    "fa",
+    "fr",
+    "it",
+    "lt",
+    "zh-cn",
+    "zh-tw",
+]
+
+
+def language_name_column(language: str, column_prefix: str = "name") -> str:
+    # if language.lower() not in LANGUAGES:
+    #     raise ValueError("Unsupported language")
+
+    language_name = language.replace("-", "_").lower()
+    return f"{column_prefix}_{language_name}"
+
+
+def translate(text: str, language: str) -> str:
+    if not text:
+        return text
+
+    translation = LABELS[language.lower()].get(text.lower())
+
+    if not translation:
+        return text
+
+    return translation.title()
+
+
+LANGUAGE_NAME_COLUMNS = [language_name_column(lang) for lang in LANGUAGES]