Function Repository Resource:

AstroListPlot (1.0.0) current version: 1.1.1 »

Source Notebook

Visualize a list of astronomical entities

Contributed by: Jeff Bryant

ResourceFunction["AstroListPlot"][{entity}]

highlights the specified entity if it is above the horizon for your current location and date.

ResourceFunction["AstroListPlot"][{entity1,entity2,}]

highlights multiple entities.

Details and Options

Constellation entities do not generate a marker since the default behavior already includes constellation borders and name labels.
ResourceFunction["AstroListPlot"] has the same options as AstroGraphics with the following additions:
"MarkerColor"Whitemarker color
"MarkerSize"Scaled[.05]marker size

Examples

Basic Examples (3) 

Visualize the Polaris from your location:

In[1]:=
ResourceFunction["AstroListPlot"][{Entity["Star", "Polaris"]}]
Out[1]=

Visualize a less prominent star:

In[2]:=
ResourceFunction["AstroListPlot"][{Entity["Star", "LambdaCassiopeiae"]}]
Out[2]=

Visualize a list of stars:

In[3]:=
bigdipper = EntityList[EntityClass["Star", "BigDipper"]]
Out[3]=
In[4]:=
ResourceFunction["AstroListPlot"][bigdipper]
Out[4]=

Scope (3) 

Visualize the current position of Altair from a specified location:

In[5]:=
ResourceFunction["AstroListPlot"][{Entity["Star", "Altair"]}, AstroReferenceFrame -> {"Horizon", Entity["City", {"Johannesburg", "Gauteng", "SouthAfrica"}]}, AstroRange -> All]
Out[5]=

Visualize Mizar from a specified location and time:

In[6]:=
ResourceFunction["AstroListPlot"][{Entity["Star", "Mizar"]}, AstroReferenceFrame -> {"Horizon", DateObject[{2020, 8, 4, 15, 30}], GeoPosition[{40.11, -88.22}]}]
Out[6]=

Visualize the sky from a specified location and time and highlight Polaris and Venus:

In[7]:=
ResourceFunction["AstroListPlot", ResourceVersion->"1.0.0"][{Entity["Planet", "Venus"], Entity["Star", "Polaris"]},
  AstroReferenceFrame -> {"Horizon", DateObject[{2020, 8, 4, 15, 30}],
    GeoPosition[{40.11, -88.22}]}, "MarkerSize" -> Scaled[.1]]
Out[7]=

Options (19) 

AstroBackground (6) 

Visualize the sky with a white background:

In[8]:=
ResourceFunction["AstroListPlot"][{Entity["Star", "Alioth"]}, AstroBackground -> "WhiteSky"]
Out[8]=

Use a background showing the Milky Way:

In[9]:=
ResourceFunction["AstroListPlot"][{Entity["Star", "Deneb"]}, AstroReferenceFrame -> {"Horizon", DateObject[{2022, 10, 23, 15, 0, 0}]}, AstroBackground -> "GalacticSky", AstroRange -> All]
Out[9]=

Add constellation illustrations and remove the equatorial, ecliptic and galactic planes:

In[10]:=
ResourceFunction["AstroListPlot"][{Entity["Star", "Betelgeuse"]}, AstroRange -> Quantity[30, "AngularDegrees"], AstroReferenceFrame -> "Equatorial", AstroBackground -> AstroStyling[{"BlackSky", "ShowConstellationIllustrations" -> True, "ShowMainPlanes" -> False}]]
Out[10]=

In[11]:=
ResourceFunction["AstroListPlot"][{Entity["Star", "Shaula"]}, AstroRange -> Quantity[20, "AngularDegrees"], AstroBackground -> "GalacticSky", AstroReferenceFrame -> "Ecliptic"]
Out[11]=

Visualize the sky and highlight specific constellation boundaries:

In[12]:=
ResourceFunction["AstroListPlot", ResourceVersion->"1.0.0"][{Entity["Star", "Mizar"], Entity["Star", "Alnitak"]},
  AstroReferenceFrame -> {"Horizon", GeoPosition[{40.11, -88.22}], DateObject[{2020, 8, 4, 10, 30}]}, AstroRange -> All, AstroBackground -> AstroStyling[{"BlackSky", "ShowConstellations" -> {Entity["Constellation", "Orion"], Entity["Constellation", "UrsaMajor"]}}]]
Out[12]=

Visualize the sky with constellation lines:

In[13]:=
ResourceFunction["AstroListPlot"][{Entity["Star", "Spica"]}, AstroReferenceFrame -> {"Horizon", DateObject[{2020, 8, 4, 15, 30}], GeoPosition[{40.11, -88.22}]}, AstroRange -> All, AstroBackground -> AstroStyling[{"BlackSky", "ShowConstellations" -> True}]]
Out[13]=

AstroCenter (1) 

Display Mercury and Venus, centering the map at the position of the Sun:

In[14]:=
ResourceFunction["AstroListPlot", ResourceVersion->"1.0.0"][{Entity["Planet", "Mercury"], Entity["Planet", "Venus"]}, AstroCenter -> Entity["Star", "Sun"], AstroReferenceFrame -> "Ecliptic", "MarkerSize" -> Scaled[.1]]
Out[14]=

AstroGridLines (2) 

Visualize the sky with the equatorial coordinate grid visible:

In[15]:=
ResourceFunction["AstroListPlot"][{Entity["Star", "Arcturus"]}, AstroReferenceFrame -> {"Horizon", DateObject[{2020, 8, 4, 15, 30}], GeoPosition[{40.11, -88.22}]}, AstroGridLines -> Automatic, AstroRange -> All]
Out[15]=

Use equatorial grid lines in the same ecliptic map:

In[16]:=
ResourceFunction["AstroListPlot"][{Entity["Star", "Arcturus"]}, AstroReferenceFrame -> {"Horizon", DateObject[{2020, 8, 4, 15, 30}], GeoPosition[{40.11, -88.22}]}, AstroGridLines -> {"Equatorial" -> Automatic}, AstroRange -> All]
Out[16]=

AstroGridLinesStyle (1) 

Change the default style of the astro grid lines:

In[17]:=
ResourceFunction["AstroListPlot"][{Entity["Star", "Capella"]}, AstroReferenceFrame -> {"Horizon", DateObject[{2025, 7, 25, 10}, TimeZone -> -5]}, AstroGridLines -> Automatic, AstroGridLinesStyle -> Directive[Dashed, Opacity[0.4, Lighter[Red]]],
  AstroRange -> All]
Out[17]=

AstroProjection (1) 

Use different projections:

In[18]:=
date = DateObject[{2020, 12, 21, 18, 0, 0}, TimeZone -> "America/Chicago"];
In[19]:=
ResourceFunction["AstroListPlot"][{Entity["Planet", "Jupiter"]}, AstroProjection -> "LambertAzimuthal", AstroRangePadding -> None, AstroReferenceFrame -> {"Equatorial", date, Here}, AstroRange -> {All, All}]
Out[19]=
In[20]:=
ResourceFunction["AstroListPlot"][{Entity["Star", "Megrez"]}, AstroProjection -> "WinkelTripel", AstroRangePadding -> None, AstroRange -> {All, All}]
Out[20]=

AstroRange (1) 

Show 10 angular degrees around the current position of Jupiter:

In[21]:=
ResourceFunction["AstroListPlot"][{Entity["Planet", "Jupiter"]}, AstroRange -> Quantity[10, "AngularDegrees"]]
Out[21]=

AstroRangePadding (1) 

Add 5 angular degrees of padding in all directions around the range including two stars:

In[22]:=
ResourceFunction["AstroListPlot", ResourceVersion->"1.0.0"][{Entity["Star", "Rigel"], Entity["Star", "Betelgeuse"]}, AstroReferenceFrame -> "Ecliptic", AstroRangePadding -> Quantity[5, "AngularDegrees"]]
Out[22]=

AstroReferenceFrame (4) 

By default, AstroListPlot uses the local horizon frame and the "Stereographic" projection:

In[23]:=
ResourceFunction["AstroListPlot"][{Entity["Star", "Mizar"]}, AstroRange -> All]
Out[23]=

Show the full sky, using the equatorial frame, in the "Equirectangular" projection:

In[24]:=
ResourceFunction["AstroListPlot"][{Entity["Star", "Mizar"]}, AstroReferenceFrame -> {"Equatorial", Now, Here}, AstroRange -> All]
Out[24]=

Show the full sky, using the ecliptic frame, in the "Equirectangular" projection:

In[25]:=
ResourceFunction["AstroListPlot"][{Entity["Star", "Polaris"]}, AstroReferenceFrame -> {"Ecliptic", Now, Here}, AstroRange -> All]
Out[25]=

Show the full sky, using the galactic frame, with the result using the "Mollweide" projection:

In[26]:=
ResourceFunction["AstroListPlot"][{Entity["Star", "Polaris"]}, AstroReferenceFrame -> {"Galactic", Now, Here}, AstroRange -> All]
Out[26]=

MarkerColor (1) 

Change the color of the marker:

In[27]:=
ResourceFunction["AstroListPlot"][{Entity["Star", "Polaris"]}, "MarkerColor" -> Magenta]
Out[27]=

MarkerSize (1) 

Zoom in around Jupiter until you see the positions of the Galilean satellites:

In[28]:=
ResourceFunction["AstroListPlot"][{Entity["Planet", "Jupiter"]}, AstroRange -> Quantity[0.04, "AngularDegrees"], "MarkerSize" -> Scaled[.3]]
Out[28]=

Neat Examples (1) 

Specify styling directives for a constellation:

In[29]:=
style = {"ShowConstellationIllustrations" -> True, "ShowConstellationRegions" -> True, "ConstellationRegionStyle" -> Darker[Blue, .2], "ConstellationLineStyle" -> Opacity[0.6, LightBlue], "ShowConstellationBoundaries" -> True, "ConstellationBoundaryStyle" -> Directive[Dashing[{0, Tiny}], Yellow], "ConstellationNameStyle" -> GrayLevel[0.7], "ShowSolarSystemObjects" -> False};
In[30]:=
ResourceFunction["AstroListPlot"][{Entity["Constellation", "Scorpius"]},
  AstroBackground -> AstroStyling[{"GalacticSky", "ShowConstellations" -> {Entity["Constellation", "Scorpius"]}, style}], AstroReferenceFrame -> "J2000"]
Out[30]=

Version History

  • 1.1.1 – 15 September 2025
  • 1.1.0 – 29 August 2025
  • 1.0.0 – 22 August 2025

Related Resources

License Information