starplot 0.20.3__tar.gz → 0.20.5__tar.gz

{starplot-0.20.3 → starplot-0.20.5}/.gitignore

@@ -38,12 +38,16 @@ temp.py
 temp/
 # raw/
 scripts/temp/
+plots/
+scripts/__marimo__/
 
 # Documentation Generated Files
 examples/*.png
 examples/*.jpg
+examples/*.svg
 docs/images/examples/*.png
 docs/images/examples/*.jpg
+docs/images/examples/*.svg
 tutorial/*.png
 docs/images/tutorial/*.png
 docs/data/*.json
@@ -152,6 +156,8 @@ ENV/
 env.bak/
 venv.bak/
 
+uv.lock
+
 # Spyder project settings
 .spyderproject
 .spyproject

{starplot-0.20.3 → starplot-0.20.5}/CITATION.cff

@@ -20,5 +20,5 @@ keywords:
   - graphs
   - plotting
 license: MIT
-version: 0.20.3
-date-released: '2026-04-30'
+version: 0.20.5
+date-released: '2026-08-18'

{starplot-0.20.3 → starplot-0.20.5}/Makefile

@@ -125,10 +125,10 @@ docs-publish:
 # ------------------------------------------------------------------
 # PyPi - build & publish
 flit-build:
-	$(DOCKER_RUN) "python -m flit build"
+	$(DOCKER_RUN) "uv run flit build"
 
 flit-publish:
-	$(DOCKER_RUN) "python -m flit publish"
+	$(DOCKER_RUN) "uv run flit publish"
 
 flit-install:
 	FLIT_ROOT_INSTALL=1 flit install

{starplot-0.20.3 → starplot-0.20.5}/PKG-INFO

@@ -1,9 +1,10 @@
 Metadata-Version: 2.4
 Name: starplot
-Version: 0.20.3
+Version: 0.20.5
 Summary: Star charts and maps of the sky
 Keywords: astronomy,stars,charts,maps,constellations,sky,plotting
 Author-email: Steve Berardi <hello@steveberardi.com>
+Requires-Python: >=3.10
 Description-Content-Type: text/markdown
 Classifier: License :: OSI Approved :: MIT License
 Classifier: Programming Language :: Python :: 3
@@ -13,7 +14,7 @@ Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
 Classifier: Framework :: Matplotlib
 License-File: LICENSE
-Requires-Dist: matplotlib >= 3.8.0
+Requires-Dist: matplotlib <= 3.10.9
 Requires-Dist: numpy >= 1.26.2
 Requires-Dist: pandas <= 2.2.3
 Requires-Dist: pydantic >= 2.10.6
@@ -55,7 +56,7 @@ Project-URL: Source, https://github.com/steveberardi/starplot
 - 🚀 **Data Backend** - powered by DuckDB + Ibis for fast object lookup
 - 📓 **Custom Data Catalogs** - with helpers for building and optimizing
 - 🧭 **Label Collision Avoidance** - ensuring all labels are readable
-- 🌐 **Localization** - label translations for Chinese, French, Lithuanian, Persian, and Spanish
+- 🌐 **Localization** - label translations for Chinese, French, Italian, Lithuanian, Persian, and Spanish
 
 ## Examples
 *Zenith chart of the stars from a specific time/location:*

{starplot-0.20.3 → starplot-0.20.5}/README.md

@@ -18,7 +18,7 @@
 - 🚀 **Data Backend** - powered by DuckDB + Ibis for fast object lookup
 - 📓 **Custom Data Catalogs** - with helpers for building and optimizing
 - 🧭 **Label Collision Avoidance** - ensuring all labels are readable
-- 🌐 **Localization** - label translations for Chinese, French, Lithuanian, Persian, and Spanish
+- 🌐 **Localization** - label translations for Chinese, French, Italian, Lithuanian, Persian, and Spanish
 
 ## Examples
 *Zenith chart of the stars from a specific time/location:*

starplot-0.20.5/data/raw/translations/it/constellation_names.csv

@@ -0,0 +1,90 @@
+iau_id,English,Italian
+and,Andromeda,Andromeda
+ant,Antlia,Macchina Pneumatica
+aps,Apus,Uccello del Paradiso
+aql,Aquila,Aquila
+aqr,Aquarius,Acquario
+ara,Ara,Altare
+ari,Aries,Ariete
+aur,Auriga,Auriga
+boo,Bootes,Boote
+cae,Caelum,Bulino
+cam,Camelopardalis,Giraffa
+cap,Capricornus,Capricorno
+car,Carina,Carena
+cas,Cassiopeia,Cassiopea
+cen,Centaurus,Centauro
+cep,Cepheus,Cefeo
+cet,Cetus,Balena
+cha,Chamaeleon,Camaleonte
+cir,Circinus,Compasso
+cma,Canis Major,Cane Maggiore
+cmi,Canis Minor,Cane Minore
+cnc,Cancer,Cancro
+col,Columba,Colomba
+com,Coma Berenices,Chioma di Berenice
+cra,Corona Australis,Corona Australe
+crb,Corona Borealis,Corona Boreale
+crt,Crater,Cratere
+cru,Crux,Croce del Sud
+crv,Corvus,Corvo
+cvn,Canes Venatici,Cani da Caccia
+cyg,Cygnus,Cigno
+del,Delphinus,Delfino
+dor,Dorado,Dorado
+dra,Draco,Drago
+equ,Equuleus,Cavallino
+eri,Eridanus,Eridano
+for,Fornax,Fornace
+gem,Gemini,Gemelli
+gru,Grus,Gru
+her,Hercules,Ercole
+hor,Horologium,Orologio
+hya,Hydra,Idra
+hyi,Hydrus,Idra Maschio
+ind,Indus,Indiano
+lac,Lacerta,Lucertola
+leo,Leo,Leone
+lep,Lepus,Lepre
+lib,Libra,Bilancia
+lmi,Leo Minor,Leone Minore
+lup,Lupus,Lupo
+lyn,Lynx,Lince
+lyr,Lyra,Lira
+men,Mensa,Mensa
+mic,Microscopium,Microscopio
+mon,Monoceros,Unicorno
+mus,Musca,Mosca
+nor,Norma,Regolo
+oct,Octans,Ottante
+oph,Ophiuchus,Serpente
+ori,Orion,Orione
+pav,Pavo,Pavone
+peg,Pegasus,Pegaso
+per,Perseus,Perseo
+phe,Phoenix,Fenice
+pic,Pictor,Pittore
+psa,Piscis Austrinus,Pesce Australe
+psc,Pisces,Pesci
+pup,Puppis,Poppa
+pyx,Pyxis,Bussola
+ret,Reticulum,Reticolo
+scl,Sculptor,Scultore
+sco,Scorpius,Scorpione
+sct,Scutum,Scudo
+ser1,Serpens Caput,Serpente (testa)
+ser2,Serpens Cauda,Serpente (coda)
+sex,Sextans,Sestante
+sge,Sagitta,Freccia
+sgr,Sagittarius,Sagittario
+tau,Taurus,Toro
+tel,Telescopium,Telescopio
+tra,Triangulum Australe,Triangolo Australe
+tri,Triangulum,Triangolo
+tuc,Tucana,Tucano
+uma,Ursa Major,Orsa Maggiore
+umi,Ursa Minor,Orsa Minore
+vel,Vela,Vele
+vir,Virgo,Vergine
+vol,Volans,Pesce Volante
+vul,Vulpecula,Volpetta

starplot-0.20.5/data/raw/translations/it/dso_names.csv

@@ -0,0 +1,153 @@
+open_ngc_name,English,Italian
+IC0348,Omi Per Cloud,Ammasso Omicron Persei
+IC0349,Barnard's Merope Nebula,Nebulosa Merope di Barnard
+IC0405,Flaming Star Nebula,Nebulosa Stella Fiammeggiante
+IC0434,"Flame Nebula, Orion B",Nebulosa Testa di Cavallo
+IC0443,Gem A,Nebulosa Medusa
+IC1318,Gamma Cygni Nebula,Nebulosa di Gamma Cygni
+IC2220,Toby Jug Nebula,Nebulosa Toby Jug
+IC2391,Omicron Velorum Cluster,Ammasso Omicron Velorum
+IC2431 NED02,Browning,Galassia Browning
+IC2574,Coddington's Nebula,Nebulosa di Coddington
+IC2602,Theta Carinae Cluster,Pleiadi del Sud
+IC2944,lam Cen Nebula,Nebulosa lam Cen
+IC4604,rho Oph Nebula,Nebulosa rho Oph
+IC4703,"Eagle Nebula, Star Queen",Nebulosa Aquila
+IC4715,Small Sagittarius Star Cloud,Piccola Nube Stellare del Sagittario
+IC5070,Pelican Nebula,Nebulosa Pellicano
+IC5146,Cocoon Nebula,Nebulosa Bozzolo
+NGC0040,Bow-Tie nebula,Nebulosa Scarabeo
+NGC0104,47 Tucanae,47 Tucanae
+NGC0224,Andromeda Galaxy,Galassia di Andromeda
+NGC0246,"Skull Nebula, Caldwell 56",Nebulosa Teschio
+NGC0253,Sculptor Galaxy,Galassia dello Scultore
+NGC0292,Small Magellanic Cloud,Piccola Nube di Magellano
+NGC0457,Owl Cluster,Ammasso Libellula
+NGC0598,"Triangulum Galaxy, Triangulum Pinwheel",Galassia del Triangolo
+NGC0650,"Barbell Nebula, Cork Nebula, Little Dumbbell Nebula",Nebulosa Piccola Campana
+NGC0869,h Persei Cluster,Ammasso h Persei
+NGC0884,chi Persei Cluster,Ammasso chi Persei
+NGC1049,Fornax Dwarf Cluster 3,Ammasso Nano della Fornace 3
+NGC1275,Perseus A,Perseo A
+NGC1316,Fornax A,Fornace A
+NGC1317,Fornax B,Fornace B
+NGC1432,Maia Nebula,Nebulosa di Maia
+NGC1435,Merope Nebula,Nebulosa di Merope
+NGC1499,California Nebula,Nebulosa California
+NGC1555,"Hind's Nebula, Hind's Variable Nebula",Nebulosa di Hind
+NGC1909,the Witch Head Nebula,Nebulosa Testa di Strega
+NGC1952,Crab Nebula,Nebulosa Granchio
+NGC1976,"Great Orion Nebula, Orion Nebula",Nebulosa di Orione
+NGC1977,the Running Man Nebula,Nebulosa Uomo che Corre
+NGC1980,Lower Sword,Spada Inferiore
+NGC1981,Upper Sword,Spada Superiore
+NGC1982,Mairan's Nebula,Nebulosa di Mairan
+NGC1990,Alnilam,Alnilam
+NGC2070,"30 Dor Cluster, Tarantula Nebula",Nebulosa Tarantola
+NGC2174,Monkey Head Nebula,Nebulosa Testa di Scimmia
+NGC2237,Rosette A,Nebulosa Rosetta A
+NGC2238,Rosette Nebula,Nebulosa Rosetta
+NGC2246,Rosette B,Nebulosa Rosetta B
+NGC2261,Hubble's Nebula,Nebulosa Variabile di Hubble
+NGC2264,Christmas Tree Cluster,Albero di Natale
+NGC2301,Great Bird Cluster,Ammasso Grande Uccello
+NGC2360,Caroline's Cluster,Ammasso Caroline
+NGC2392,Eskimo Nebula,Nebulosa Eskimo
+NGC2537,"Bear Claw Nebula, Bear-Paw Galaxy",Galassia Zampa d'Orso
+NGC2573,Polarissima Australis,Polarissima Australe
+NGC2632,"Beehive, Praesepe Cluster",Ammasso del Presepe
+NGC2685,Helix Galaxy,Galassia Elica
+NGC2736,Pencil Nebula,Nebulosa Matita
+NGC3031,Bode's Galaxy,Galassia di Bode
+NGC3034,Cigar Galaxy,Galassia Sigaro
+NGC3115,Spindle Galaxy,Galassia Fuso
+NGC3132,Eight-Burst Nebula,Nebulosa Anello del Sud
+NGC3172,Polarissima Borealis,Polarissima Boreale
+NGC3242,Jupiter's Ghost Nebula,Fantasma di Giove
+NGC3372,"Carina Nebula, eta Car Nebula",Nebulosa della Carena
+NGC3532,Wishing Well Cluster,Ammasso Pozzo dei Desideri
+NGC3561,the Guitar,La Chitarra
+NGC3587,Owl Nebula,Nebulosa Gufo
+NGC3766,Pearl Cluster,Ammasso Perla
+NGC3918,Blue Planetary,Nebulosa Planetaria Blu
+NGC3928,Miniature Spiral,Spirale in miniatura
+NGC4038,Antennae Galaxies,Galassie Antenne
+NGC4039,Antennae Galaxies,Galassie Antenne
+NGC4194,Medusa Galaxy Merger,Galassia Medusa
+NGC4254,"Coma Pinwheel, Virgo Cluster Pinwheel",Ammasso della Vergine Girandola
+NGC4435,Eyes,Catena di Markarian
+NGC4438,Eyes,Catena di Markarian
+NGC4486,Virgo Galaxy,Messier 87
+NGC4565,Needle Galaxy,Galassia Ago
+NGC4567,"Butterfly Galaxies, Siamese Twins",Gemelli Siamesi
+NGC4568,"Butterfly Galaxies, Siamese Twins",Gemelli Siamesi
+NGC4594,Sombrero Galaxy,Galassia Sombrero
+NGC4609,Coalsack Cluster,Ammasso Sacco di Carbone
+NGC4631,Whale Galaxy,Galassia Balena
+NGC4651,Umbrella Galaxy,Galassia Ombrello
+NGC4676,Mice Galaxy,Galassie Topo
+NGC4755,"Herschel's Jewel Box, kappa Crucis Cluster",Scrigno di Gioielli
+NGC4826,"Black Eye Galaxy, Evil Eye Galaxy",Galassia Occhio Nero
+NGC4990,Cocoon Galaxy,Cocoon Galaxy
+NGC5055,Sunflower Galaxy,Galassia Girasole
+NGC5128,Centaurus A,Centaurus A
+NGC5139,Omega Centauri,Omega Centauri
+NGC5194,Whirlpool Galaxy,Galassia Vortice
+NGC5236,Southern Pinwheel Galaxy,Galassia Girandola del Sud
+NGC6087,S Normae Cluster,Ammasso Norma 5
+NGC6188,Firebird Nebula,Nebulosa Orlo
+NGC6205,Hercules Globular Cluster,Ammasso Globulare di Ercole
+NGC6302,"Bug Nebula, Butterfly Nebula",Nebulosa Insetto
+NGC6309,Box Nebula,Nebulosa Scatola
+NGC6357,the War and Peace Nebula,Nebulosa Guerra e Pace
+NGC6369,Little Ghost Nebula,Nebulosa Piccolo Fantasma
+NGC6405,Butterfly Cluster,Ammasso Farfalla
+NGC6445,Little Gem,Nebulosa Piccolo Gioiello
+NGC6475,Ptolemy's Cluster,Ammasso di Tolomeo
+NGC6514,Trifid Nebula,Nebulosa Trifida
+NGC6523,Lagoon Nebula,Nebulosa Laguna
+NGC6537,Red Spider Nebula,Nebulosa Ragno Rosso
+NGC6543,Cat's Eye Nebula,Nebulosa Occhio di Gatto
+NGC6611,Eagle Nebula,Nebulosa Aquila
+NGC6618,"Checkmark Nebula, Lobster Nebula, Swan Nebula, omega Nebula",Nebulosa Omega
+NGC6705,Wild Duck Cluster,Ammasso Anatra Selvatica
+NGC6720,Ring Nebula,Nebulosa Anello
+NGC6741,Phantom Streak Nebula,Galassia Phantom Streak
+NGC6818,Little Gem Nebula,Nebulosa Piccolo Gioiello
+NGC6819,Foxhead Cluster,Ammasso Testa di Volpe
+NGC6822,Barnard's Galaxy,Galassia di Barnard
+NGC6826,Blinking Planetary,Nebulosa Planetaria Intermittente
+NGC6853,Dumbbell Nebula,Nebulosa Manubrio
+NGC6888,Crescent Nebula,Nebulosa Crescente
+NGC6905,Blue Flash Nebula,Nebulosa Lampo Blu
+NGC6946,Fireworks Galaxy,Galassia Fuochi d'Artificio
+NGC6960,"Veil Nebula, Filamentary Nebula, Western Veil",Nebulosa Velo
+NGC6992,"Eastern Veil, Network Nebula",Nebulosa Velo dell'Est
+NGC6995,"Eastern Veil, Network Nebula",Nebulosa Velo dell'Est
+NGC7000,North America Nebula,Nebulosa Nord America
+NGC7009,Saturn Nebula,Nebulosa Saturno
+NGC7023,Iris Nebula,Nebulosa Iris
+NGC7114,Schmidt's Nova Cygni,Q Cygni
+NGC7293,Helix Nebula,Nebulosa Elica
+NGC7635,Bubble Nebula,Nebulosa Bolla
+NGC7662,Copeland's Blue Snowball,Nebulosa Palla di Neve
+B033,Horsehead Nebula,Nebulosa Testa di Cavallo
+C009,Cave Nebula,Nebulosa Grotta
+C014,"Double Cluster, h & chi Persei",Ammasso doppio di Perseo
+C041,Hyades,Iadi
+C099,Coalsack Nebula,Nebulosa Sacco di Carbone
+Cl399,"Brocchi's Cluster, Al Sufi's Cluster, Coathanger Asterism",Ammasso di Brocchi
+ESO056-115,"Large Magellanic Cloud, Nubecula Major",Grande Nube di Magellano
+ESO097-013,Circinus Galaxy,Galassia del Compasso
+ESO270-017,Fourcade-Figueroa,Fourcade-Figueroa
+ESO351-030,Sculptor Dwarf Elliptical,Galassia nana dello Scultore
+ESO356-004,Fornax Dwarf Spheroidal,Galassia nana della Fornace
+HCG079,Seyfert's Sextet,Sestetto di Seyfert
+HCG092,Stephan's Quintet,Quintetto di Stephan
+Mel022,Pleiades,Pleiadi
+Mel111,Coma Star Cluster,Ammasso della Chioma di Berenice
+PGC000143,Wolf-Lundmark-Melotte Galaxy,Galassia di Wolf-Lundmark-Melotte
+PGC029653,Sextans A,Sestante A
+PGC088608,Sextans Dwarf Spheroidal,Galassia nana del Sestante
+UGC05373,Sextans B,Sestante B
+UGC05470,Leo I,Leo I

starplot-0.20.5/data/raw/translations/it/other_terms.csv

@@ -0,0 +1,43 @@
+English,Italian
+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
+Mercury,Mercurio
+Venus,Venere
+Mars,Marte
+Jupiter,Giove
+Saturn,Saturno
+Uranus,Uranuo
+Neptune,Nettuno
+Pluto,Plutone
+Sun,Sole
+Moon,Luna
+North,Nord
+East,Est
+South,Sud
+West,Ovest
+Ecliptic,Eclittica
+Celestial Equator,Equatore celeste
+N (abbreviation for north),N
+E (abbreviation for east),E
+S (abbreviation for south),S
+W (abbreviation for west),O
+Milky Way,Via Lattea

starplot-0.20.5/data/raw/translations/it/readme.md

@@ -0,0 +1,55 @@
+# Notes on the Italian translation
+
+Italian translations of stars, constellation names, and DSO objects
+are derived from:
+
+- [Italian Wikipedia](https://it.wikipedia.org/)
+- [Stellarium](https://stellarium.org/)
+- Ian Ridpath, Wil Tirion, _Guida delle Stelle e dei Pianeti_, Franco
+  Muzzio Editore, 1988, ISBN 88-7413-071-6 (this is the Italian
+  translation of _Guide to Stars and Planets_ by the Authors).
+- _Universo--guida di viaggio_, Lonely Planet, 2019, ISBN
+  978-88-5925-751-6.
+- Patrick Moore, _Il Guinness dell'astronomia_, Biblioteca Universale
+  Rizzoli, 1990, ISBN 88-17-11161-9.
+- Giancarlo Favero, _Guida alla osservazione del cielo_, Arnoldo
+  Mondadori Editore, 1984,
+
+## Constellations
+
+Most of the constellation names are standard. However, there are a
+couple of special exceptions. One is the constellation _Bootes_, which
+might be translated as _Boote_, _Bovaro_, or _Bifolco_. Here we use
+_Boote_ since this is what Stellarium uses, as well as the Italian
+association for amateur astronomers (UAI). The other exception is the
+constellation _Norma_, which is sometimes translated as _Regolo_ or,
+more rarely, _Squadra_. The most common translation seems to be
+_Regolo_, so it is used here.
+
+## Stars
+
+There are just a handful of stars whose names are routinely translated
+in Italian (i.e., _Regolo_, _Arturo_, _Sirio_, etc.).  All sources I
+have consulted agree on the translations, so there should be no
+problems here.
+
+## Deep Sky Objects
+
+DSOs are problematic. The scientific literature is all in English, so
+there are no standard Italian translations. The names used here are
+mostly taken from Stellarium or from the Italian Wikipedia.
+
+Sometimes more than one translation is used, e.g., the Owl cluster
+(NGC 457) might be referred to as _Ammasso Libellula_, _Ammasso
+Civetta_ or _Ammasso Gufo_ (_civetta_ and _gufo_ are both translations
+of "owl", although they refer to different birds); Stellarium prefers
+_libellula_, so this is used.  Another example is "Brocchi's Cluster"
+(Collinder 399), which is translated as _Ammasso di Brocchi_,
+_Attaccapanni_, or _Appendiabiti_ (the latter two meaning
+"coathanger"). Here se use _Ammasso di Brocchi_.
+
+Where no Italian name is commonly used but the English denomination
+has an obvious translation, the latter is used. For example, the
+Running Man Nebula (NGC 1977) has been translated literally as
+_Nebulosa Uomo che Corre_ although Stellarium calls it _Nebulosa
+Running Man_ ("Nebulosa" == "Nebula").