is an option of AstroGraphics that specifies the included range of coordinates on the celestial sphere.


  • AstroRange provides the main way to specify explicit regions of the celestial sphere to include in AstroGraphics maps.
  • The following settings can be used:
  • Allthe entire celestial sphere is included
    Automaticautomatically select the region to display
    Fullsame as All when used in astro graphics
    {{lon1,lon2},{lat1,lat2}}explicit limits for spherical coordinates
    {All,{lat1,lat2}}complete longitude range and specified latitude range
    {{lon1,lon2},All}specified longitude range and complete latitude range
    rexplicit numerical radius, assumed to be in angular degrees
    quantityexplicit radius as a Quantity angle
    entityuse bounding box of the given astro entity
  • AstroRanger or AstroRangequantity represents a range enclosing a spherical circle of the given radius around the center specified by AstroCenter or by the content of the first argument of AstroGraphics.
  • AstroRangeAutomatic selects a region adapted to the content of the first argument of AstroGraphics. For a pointlike case, like a star, a spherical disk of 10 angular degrees around that point is used. With no input information, as in AstroGraphics[], the full celestial sphere or a hemisphere of it will be selected, depending on the selected astro reference frame and projection.
  • AstroRangePadding can be used to extend the bounding box defined by AstroRange.
  • Options[amap,AstroRange] returns the AstroRange value used in the AstroGraphics map amap.


open allclose all

Basic Examples  (2)

Visualize the current sky toward your local north:

Specify a center and an angular radius around it:

Scope  (4)

Specify all four coordinate limits:

Show a band of the sky around the ecliptic:

Show one hemisphere in equatorial coordinates:

Show an area of 1.5 degrees radius around M31:

Specify the same radius using a number, understood in angular degrees:

Alternatively, use a mixed quantity:

Wolfram Research (2022), AstroRange, Wolfram Language function,


Wolfram Research (2022), AstroRange, Wolfram Language function,


Wolfram Language. 2022. "AstroRange." Wolfram Language & System Documentation Center. Wolfram Research.


Wolfram Language. (2022). AstroRange. Wolfram Language & System Documentation Center. Retrieved from


@misc{reference.wolfram_2024_astrorange, author="Wolfram Research", title="{AstroRange}", year="2022", howpublished="\url{}", note=[Accessed: 20-June-2024 ]}


@online{reference.wolfram_2024_astrorange, organization={Wolfram Research}, title={AstroRange}, year={2022}, url={}, note=[Accessed: 20-June-2024 ]}