matplotlib-map-utils 4.0.0__tar.gz → 4.1.0__tar.gz

{matplotlib_map_utils-4.0.0/matplotlib_map_utils.egg-info → matplotlib_map_utils-4.1.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: matplotlib-map-utils
-Version: 4.0.0
+Version: 4.1.0
 Summary: A suite of tools for creating maps in matplotlib
 Author-email: David Moss <davidmoss1221@gmail.com>
 Project-URL: Homepage, https://github.com/moss-xyz/matplotlib-map-utils/
@@ -15,6 +15,7 @@ License-File: LICENSE
 Requires-Dist: matplotlib>=3.9.0
 Requires-Dist: cartopy>=0.23.0
 Requires-Dist: great-circle-calculator>=1.3.1
+Requires-Dist: pydantic>=2.13.3
 Dynamic: license-file
 
 ![matplotlib_map_utils logo](docs/assets/index/mmu_logo_w_elements.png)
@@ -27,7 +28,7 @@ Dynamic: license-file
 
 **Feedback:** I welcome any and all feedback! See the *Development Notes* below for more details.
 
-**Current Version:** `v4.0.0`, featuring a brand-new documentation site!
+**Current Version:** `v4.1.0`, featuring a brand-new documentation site and improved type validation! This DID introduce some breaking changes, see the documentation site for details!
 
 ---
 
@@ -35,7 +36,7 @@ Dynamic: license-file
 
 `matplotlib_map_utils` is a package that that assists with the creation of maps using [`matplotlib`](https://matplotlib.org/stable/).
 
-As of `v3.x` (the current version), this includes the ability to easily create three common map elements: 
+As of `v4.x` (the current version), this includes the ability to easily create three common map elements: 
 
 * <span style="color: orange; font-weight: bold;">North arrows</span>, which automatically point to true north,
 
@@ -73,6 +74,8 @@ The requirements for this package are:
 
 * `cartopy >= 0.23` (due to earlier bug with calling `copy()` on `CRS` objects)
 
+* `pydantic >= 2.13.3` (for type validation; might work with older versions, open an issue if you have questions)
+
 ---
 
 ### Quick Start and Usage Guides

{matplotlib_map_utils-4.0.0 → matplotlib_map_utils-4.1.0}/README.md

@@ -8,7 +8,7 @@
 
 **Feedback:** I welcome any and all feedback! See the *Development Notes* below for more details.
 
-**Current Version:** `v4.0.0`, featuring a brand-new documentation site!
+**Current Version:** `v4.1.0`, featuring a brand-new documentation site and improved type validation! This DID introduce some breaking changes, see the documentation site for details!
 
 ---
 
@@ -16,7 +16,7 @@
 
 `matplotlib_map_utils` is a package that that assists with the creation of maps using [`matplotlib`](https://matplotlib.org/stable/).
 
-As of `v3.x` (the current version), this includes the ability to easily create three common map elements: 
+As of `v4.x` (the current version), this includes the ability to easily create three common map elements: 
 
 * <span style="color: orange; font-weight: bold;">North arrows</span>, which automatically point to true north,
 
@@ -54,6 +54,8 @@ The requirements for this package are:
 
 * `cartopy >= 0.23` (due to earlier bug with calling `copy()` on `CRS` objects)
 
+* `pydantic >= 2.13.3` (for type validation; might work with older versions, open an issue if you have questions)
+
 ---
 
 ### Quick Start and Usage Guides

{matplotlib_map_utils-4.0.0/site → matplotlib_map_utils-4.1.0/docs}/assets/index/generator_map.py

@@ -35,14 +35,14 @@ georgia.buffer(75000).plot(ax=ax, facecolor="none", edgecolor="none") # this hel
 georgia.plot(ax=ax, edgecolor="black", facecolor="none")
 
 # Creating an inset map and extent indicator for the USA
-cax = inset_map(ax, "lower right", size=1.75, pad=0.1, xticks=[], yticks=[])
+cax = inset_map(ax, location="lower right", imsize=1.75, pad=0.1, xticks=[], yticks=[])
 contiguous.plot(ax=cax, facecolor="none", edgecolor="black", linewidth=0.5)
 indicate_extent(cax, ax, 3857, 3857)
 
 # Creating an inset map and detail indicator for Atlanta, GA
 atl_centroid = shapely.Point(pyproj.Transformer.from_crs(4326, 3857, always_xy=True).transform(-84.40123859860549, 33.75203795433787))
 atl_buffer = atl_centroid.buffer(20000)
-aax = inset_map(ax, "upper right", size=1.75, pad=0.25, xticks=[], yticks=[])
+aax = inset_map(ax, location="upper right", imsize=1.75, pad=0.25, xticks=[], yticks=[])
 geopandas.GeoSeries(atl_buffer).plot(ax=aax, facecolor="none", edgecolor="none")
 indicate_detail(ax, aax, 3857, 3857, linecolor="cornflowerblue")
 

{matplotlib_map_utils-4.0.0/site → matplotlib_map_utils-4.1.0/docs}/assets/inset_maps/generator.py

@@ -37,6 +37,7 @@ hawaii = states.query(f"GEOID == '{usa.filter_abbr("HI")}'").to_crs(4135)
 hawaii.geometry = [shapely.MultiPolygon([g for g in hawaii.iloc[0].geometry.geoms if g.area>1e-3])]
 
 from matplotlib_map_utils import InsetMap, inset_map, ExtentIndicator, indicate_extent, DetailIndicator, indicate_detail
+from matplotlib_map_utils import config
 
 #------------------------------------------------
 # usa_w_alaska_func.png
@@ -48,7 +49,7 @@ fig, ax = new_map()
 contiguous.plot(ax=ax)
 
 # Adding an inset map to the plot
-iax = inset_map(ax, location="lower left", size=0.8, pad=0.1, xticks=[], yticks=[])
+iax = inset_map(ax, location="lower left", imsize=0.8, pad=0.1, xticks=[], yticks=[])
 # Plotting alaska in the inset map
 alaska.plot(ax=iax)
 
@@ -67,7 +68,7 @@ contiguous.plot(ax=ax)
 # Creating an InsetMap object that we want to place in the lower-right corner of the axis, 
 # Note that here, we do not specify the "parent" axis (ax)
 # Note that we also tell it what data we are going to want to plot there, but this is optional!
-im = InsetMap("lower left", size=0.8, pad=0.1, to_plot={"data":hawaii}, xticks=[], yticks=[])
+im = InsetMap("lower left", imsize=0.8, pad=0.1, to_plot={"data":hawaii}, xticks=[], yticks=[])
 # The InsetMap can then be added using create()
 # Note that this is DIFFERENT than NorthArrow and ScaleBar objects, which rely on add_artist()!
 iax = im.create(ax)
@@ -88,7 +89,7 @@ for ax,l in zip(axs.flatten(), locs):
 	ax.set_aspect(1, adjustable="datalim") # this is just making things square-ish for us
 	ax.set_title(l)
 	# Creating the inset map at our specified location
-	inset_map(ax=ax, location=l, size=0.5, pad=0.05, xticks=[], yticks=[])
+	inset_map(ax=ax, location=l, imsize=0.5, pad=0.05, xticks=[], yticks=[])
 
 matplotlib.pyplot.savefig("./location_grid.png", bbox_inches="tight")
 matplotlib.pyplot.close()
@@ -99,9 +100,9 @@ matplotlib.pyplot.close()
 
 # Changing size and padding
 modifications = [
-	{"size":0.25,"pad":0},
-	{"size":0.5,"pad":0},
-	{"size":0.25, "pad":0.25},
+	{"imsize":0.25,"pad":0},
+	{"imsize":0.5,"pad":0},
+	{"imsize":0.25, "pad":0.25},
 ]
 fig, axs = new_map(1,3, figsize=(9,3))
 for ax,l,m in zip(axs.flatten(), locs, modifications):
@@ -124,7 +125,7 @@ fig, axs = new_map(1,2, figsize=(10,5))
 for ax,z in zip(axs.flatten(), zorders):
 	states.query(f"NAME=='Georgia'").plot(ax=ax, zorder=z["plot"])
 	ax.set_aspect(1, adjustable="datalim")
-	inset_map(ax=ax, location="upper left", size=1, pad=0.05, xticks=[], yticks=[], zorder=z["inset"])
+	inset_map(ax=ax, location="upper left", imsize=1, pad=0.05, xticks=[], yticks=[], zorder=z["inset"])
 
 matplotlib.pyplot.savefig("./zorder.png", bbox_inches="tight")
 matplotlib.pyplot.close()
@@ -139,11 +140,11 @@ for ax,l,m in zip(axs.flatten(), locs, modifications):
 	ax.set_aspect(1, adjustable="datalim") # this is just making things square-ish for us
 
 # First, a default for comparison
-inset_map(ax=axs[0], location="upper right", size=0.8, pad=0.05, xticks=[], yticks=[])
+inset_map(ax=axs[0], location="upper right", imsize=0.8, pad=0.05, xticks=[], yticks=[])
 # Placing the upper right corner of the inset axes in the middle of the map
-inset_map(ax=axs[1], location="upper right", size=0.8, pad=0.05, coords=(0.5,0.5), xticks=[], yticks=[])
+inset_map(ax=axs[1], location="upper right", imsize=0.8, pad=0.05, coords=(0.5,0.5), xticks=[], yticks=[])
 # Placing the upper left corner of the inset axes on Atlanta, GA, using ax.transData
-inset_map(ax=axs[2], location="upper left", size=0.8, pad=0.05, coords=(-9353446,4007500), transform=axs[2].transData, xticks=[], yticks=[])
+inset_map(ax=axs[2], location="upper left", imsize=0.8, pad=0.05, coords=(-9353446,4007500), transform=axs[2].transData, xticks=[], yticks=[])
 
 matplotlib.pyplot.savefig("./locations.png", bbox_inches="tight")
 matplotlib.pyplot.close()
@@ -156,7 +157,7 @@ matplotlib.pyplot.close()
 # One common use-case for this would be displaying a map of the US as you plot multiple individual US states
 
 # Defining the inset map
-im = InsetMap("lower left", size=0.8, pad=0.05, xticks=[], yticks=[], 
+im = InsetMap("lower left", imsize=0.8, pad=0.05, xticks=[], yticks=[], 
 							to_plot=[{"data":contiguous, "kwargs":{"facecolor":"red"}}])
 
 # Creating 1x3 subplots
@@ -186,7 +187,7 @@ fig, ax = new_map()
 contiguous.plot(ax=ax)
 
 # Adding an inset map to the plot with some kwargs for xticks, yticks, and facecolor
-iax = inset_map(ax, location="lower left", size=0.8, pad=0.1, xticks=[], yticks=[], facecolor="red")
+iax = inset_map(ax, location="lower left", imsize=0.8, pad=0.1, xticks=[], yticks=[], facecolor="red")
 # Plotting alaska in the inset map
 alaska.plot(ax=iax)
 
@@ -204,9 +205,9 @@ contiguous.plot(ax=ax)
 
 # Adding multiple inset maps to the plot
 # Also using facecolor so you can see which is which
-iax = inset_map(ax, location="lower left", size=0.25, pad=0.1, xticks=[], yticks=[], facecolor="red") 
-iax = inset_map(ax, location="lower right", size=0.25, pad=0.1, xticks=[], yticks=[], facecolor="blue")
-iax = inset_map(ax, location="center right", size=0.25, pad=0.1, xticks=[], yticks=[], facecolor="green")
+iax = inset_map(ax, location="lower left", imsize=0.25, pad=0.1, xticks=[], yticks=[], facecolor="red") 
+iax = inset_map(ax, location="lower right", imsize=0.25, pad=0.1, xticks=[], yticks=[], facecolor="blue")
+iax = inset_map(ax, location="center right", imsize=0.25, pad=0.1, xticks=[], yticks=[], facecolor="green")
 
 matplotlib.pyplot.savefig("./multiple_insets.png", bbox_inches="tight")
 matplotlib.pyplot.close()
@@ -224,7 +225,7 @@ contiguous.plot(ax=ax)
 
 # Creating all the axes at once
 # Note that each of the 4 states can be turned off individually!
-aax, hax, pax, dax = inset_usa(ax, alaska=True, hawaii=True, dc=True, puerto_rico=True, size=0.4, pad=0.05, xticks=[], yticks=[], box_aspect=1)
+aax, hax, pax, dax = inset_usa(ax, alaska=True, hawaii=True, dc=True, puerto_rico=True, imsize=0.4, pad=0.05, xticks=[], yticks=[], box_aspect=1)
 
 alaska.plot(ax=aax)
 hawaii.plot(ax=hax)
@@ -249,7 +250,7 @@ contiguous.plot(ax=ax, column="ALAND", edgecolor="black", linewidth=0.5,
 # Adding an axis to handle a graph below
 # Don't worry too much about this code, it is quite messy and could be done better, but it should illustrate what is possible
 jenks_land = mapclassify.FisherJenks(contiguous["ALAND"], k=5)
-gax = inset_map(ax, location="lower left", size=(1.1,0.3), pad=(0.25,0.5))
+gax = inset_map(ax, location="lower left", imsize=(1.1,0.3), pad=(0.25,0.5))
 gax.tick_params(labelsize=4)
 gax.bar(x=range(5), height=jenks_land.counts, color=matplotlib.colormaps["Blues"]([0,0.25,0.50,0.75,1]), 
     tick_label=["{:.0e}".format(b) for b in jenks_land.bins], edgecolor="black", linewidth=0.5)
@@ -265,13 +266,11 @@ matplotlib.pyplot.close()
 fig, ax = new_map(1,1, figsize=(10,5))
 # Visualizing three different sizes at various positions
 for s,l in zip(["xs","sm","md"], ["center left", "center", "center right"]):
-	# Calling the function to update the defaults
-	# Note the function exists on the CLASS, but impacts both the class and function
-	InsetMap.set_size(size=s)
-	inset_map(ax=ax, location=l, xticks=[], yticks=[])
+	# Using the size parameter directly to control the default profile
+	inset_map(ax=ax, location=l, size=s, xticks=[], yticks=[])
 
 # Resetting the sizes
-InsetMap.set_size(size="sm")
+config.DEFAULT_SIZE = "sm"
 
 matplotlib.pyplot.savefig("./set_size.png", bbox_inches="tight")
 matplotlib.pyplot.close()
@@ -281,7 +280,7 @@ matplotlib.pyplot.close()
 #------------------------------------------------
 
 # Defining the inset map
-im = InsetMap("upper right", size=1, pad=0.05, xticks=[], yticks=[], to_plot=[{"data":contiguous}])
+im = InsetMap("upper right", imsize=1, pad=0.05, xticks=[], yticks=[], to_plot=[{"data":contiguous}])
 
 # Creating a plot of Georgia
 fig, ax = new_map(1,1, figsize=(5,5))
@@ -301,7 +300,7 @@ matplotlib.pyplot.close()
 #------------------------------------------------
 
 # Setting up an inset map
-im = InsetMap(location="upper right", size=0.75, pad=0.05, xticks=[], yticks=[], to_plot=[{"data":contiguous}])
+im = InsetMap(location="upper right", imsize=0.75, pad=0.05, xticks=[], yticks=[], to_plot=[{"data":contiguous}])
 # What will be changed for each extent indicator
 modifications = [
 	{}, # default for comparison
@@ -327,7 +326,7 @@ matplotlib.pyplot.close()
 #------------------------------------------------
 
 # Defining the inset map, which will be of Washington, DC (!)
-im = InsetMap("lower right", size=0.5, pad=0.05, xticks=[], yticks=[], to_plot=[{"data":washington_dc}])
+im = InsetMap("lower right", imsize=0.5, pad=0.05, xticks=[], yticks=[], to_plot=[{"data":washington_dc}])
 
 # Creating a plot of the contiguous US
 fig, ax = new_map(1,1, figsize=(5,5))
@@ -348,7 +347,7 @@ matplotlib.pyplot.close()
 #------------------------------------------------
 
 # The code below is the same, except for the very last function
-im = InsetMap("lower right", size=0.5, pad=0.05, xticks=[], yticks=[], to_plot=[{"data":washington_dc}])
+im = InsetMap("lower right", imsize=0.5, pad=0.05, xticks=[], yticks=[], to_plot=[{"data":washington_dc}])
 
 fig, ax = new_map(1,1, figsize=(5,5))
 contiguous.plot(ax=ax)
@@ -366,7 +365,7 @@ matplotlib.pyplot.close()
 #------------------------------------------------
 
 # Setting up an inset map
-im = InsetMap("lower left", size=0.5, pad=0.05, xticks=[], yticks=[], to_plot=[{"data":states.query("NAME=='Georgia'")}])
+im = InsetMap("lower left", imsize=0.5, pad=0.05, xticks=[], yticks=[], to_plot=[{"data":states.query("NAME=='Georgia'")}])
 
 # What will be changed for each extent indicator
 modifications = [

{matplotlib_map_utils-4.0.0/site → matplotlib_map_utils-4.1.0/docs}/assets/north_arrows/generator.py

@@ -316,9 +316,8 @@ fig, ax = new_map(1,1, figsize=(10,5))
 
 # Visualizing the different sizes at various positions
 for l,s in zip([0.1, 0.2, 0.35, 0.55, 0.85], ["xs","sm","md","lg","xl"]):
-	# Calling the function to update the defaults
-	NorthArrow.set_size(size=s)
-	north_arrow(ax=ax, location="center", label={"text":s}, rotation={"degrees":0}, aob={"bbox_to_anchor":(l, 0.5), "bbox_transform":ax.transAxes})
+	# Using the size parameter to set the size directly
+	north_arrow(ax=ax, size=s, location="center", label={"text":s}, rotation={"degrees":0}, aob={"bbox_to_anchor":(l, 0.5), "bbox_transform":ax.transAxes})
 
 matplotlib.pyplot.savefig("./set_size.png", bbox_inches="tight")
 matplotlib.pyplot.close()
@@ -328,9 +327,8 @@ matplotlib.pyplot.close()
 #------------------------------------------------
 
 fig, ax = new_map()
-NorthArrow.set_size(size="sm")
 states.query("NAME=='Georgia'").plot(ax=ax)
-north_arrow(ax=ax, location="upper right", rotation={"degrees":0}, aob={"bbox_to_anchor":(1.1,1), "bbox_transform":ax.transAxes})
+north_arrow(ax=ax, size="sm", location="upper left", rotation={"degrees":0}, aob={"bbox_to_anchor":(1.05,1), "bbox_transform":ax.transAxes})
 
 matplotlib.pyplot.savefig("./external_placement.png")
 matplotlib.pyplot.close()

{matplotlib_map_utils-4.0.0/site → matplotlib_map_utils-4.1.0/docs}/assets/quick/generator.py

@@ -85,13 +85,13 @@ matplotlib.pyplot.close()
 
 fig, ax = new_map(1,2, figsize=(10,5))
 # Changing the size
-ScaleBar.set_size("sm")
+# ScaleBar.set_size() is no longer needed
 # Plotting a state (Georgia)
 states.query("NAME=='Georgia'").to_crs(3520).plot(ax=ax[0])
 states.query("NAME=='Georgia'").to_crs(3520).plot(ax=ax[1])
 # Adding a scale bar to the upper-right corner of the axis, in the same projection as whatever geodata you plotted
-scale_bar(ax=ax[0], location="upper right", style="boxes", bar={"projection":3520})
-scale_bar(ax=ax[1], location="upper right", style="ticks", bar={"projection":3520})
+scale_bar(ax=ax[0], location="upper right", size="sm", style="boxes", bar={"projection":3520})
+scale_bar(ax=ax[1], location="upper right", size="sm", style="ticks", bar={"projection":3520})
 
 matplotlib.pyplot.savefig("./scale_bar_generic.png", bbox_inches="tight")
 matplotlib.pyplot.close()
@@ -123,7 +123,7 @@ fig, ax = new_map(1,1, figsize=(5,5))
 # Plotting a state (Georgia)
 states.query("NAME=='Georgia'").to_crs(3520).plot(ax=ax)
 # Adding an inset map to the upper-right corner of the axis
-iax = inset_map(ax=ax, location="upper right", size=0.75, pad=0.25, xticks=[], yticks=[])
+iax = inset_map(ax=ax, location="upper right", imsize=0.75, pad=0.25, xticks=[], yticks=[])
 
 matplotlib.pyplot.savefig("./inset_map_generic.png", bbox_inches="tight")
 matplotlib.pyplot.close()
@@ -137,8 +137,8 @@ fig, ax = new_map(1,2, figsize=(10,5))
 states.query("NAME=='Georgia'").to_crs(3520).plot(ax=ax[0])
 states.query("NAME=='Georgia'").to_crs(3520).plot(ax=ax[1])
 # Adding an inset map to the upper-right corner of the axis
-iax0 = inset_map(ax=ax[0], location="upper right", size=1, pad=0.25, xticks=[], yticks=[])
-iax1 = inset_map(ax=ax[1], location="upper right", size=0.75, pad=0.25, xticks=[], yticks=[])
+iax0 = inset_map(ax=ax[0], location="upper right", imsize=1, pad=0.25, xticks=[], yticks=[])
+iax1 = inset_map(ax=ax[1], location="upper right", imsize=0.75, pad=0.25, xticks=[], yticks=[])
 # Adding an extent indicator for the map on the left
 contiguous.plot(ax=iax0, facecolor="none", edgecolor="black", linewidth=0.5)
 indicate_extent(iax0, ax[0], 3857, 3520, pad=0.25)

{matplotlib_map_utils-4.0.0/site → matplotlib_map_utils-4.1.0/docs}/assets/scale_bars/generator.py

@@ -142,8 +142,8 @@ matplotlib.pyplot.close()
 # locations.png
 #------------------------------------------------
 
-# Do not worry about this: it is covered later, it is simply updating the default size of the scale bar
-ScaleBar.set_size("xs")
+# Do not worry about this: it is covered later, it is simply updating the default size of the scale bar to xs
+# ScaleBar.set_size() is no longer needed — pass size= directly instead
 # Grid of location options
 # Note that the "center" options will feel slightly off: this is because the the center of the scale bar is of the entire artist, text included, not just the bar itself
 locs = ["upper left", "upper center", "upper right", "center left", "center", "center right", "lower left", "lower center", "lower right"]
@@ -151,7 +151,7 @@ fig, axs = new_map(3,3, figsize=(9,9))
 for ax,l in zip(axs.flatten(), locs):
 	states.query(f"NAME=='Georgia'").plot(ax=ax)
 	ax.set_aspect(1, adjustable="datalim")
-	scale_bar(ax=ax, location=l, style="boxes", bar={"projection":3857,"minor_type":"none"}, labels={"style":"first_last"})
+	scale_bar(ax=ax, size="xs", location=l, style="boxes", bar={"projection":3857,"minor_type":"none"}, labels={"style":"first_last"})
 
 matplotlib.pyplot.savefig("./locations.png", bbox_inches="tight")
 matplotlib.pyplot.close()
@@ -161,7 +161,7 @@ matplotlib.pyplot.close()
 #------------------------------------------------
 
 # Just reverting the change I made above; again this is explained later, don't worry about it for now
-ScaleBar.set_size("md")
+# (No longer needed: we pass size= directly now)
 # Modifying the styles
 styles = ["boxes","ticks"]
 # Creating 1x2 subplots
@@ -401,7 +401,6 @@ matplotlib.pyplot.close()
 #------------------------------------------------
 
 # Modifying specific elements
-ScaleBar.set_size("md")
 
 modifications = [
 	{"facecolor": "lightgrey"}, # different facecolor
@@ -454,12 +453,10 @@ states.query(f"NAME=='California'").plot(ax=ax)
 # Visualizing three different sizes at various positions
 for s,l in zip(["sm","md","lg"], ["upper center", "center", "lower center"]):
 	# Calling the function to update the defaults
-	ScaleBar.set_size(size=s)
-	scale_bar(ax=ax, location=l, style="boxes", labels={"style":"major"}, 
+	scale_bar(ax=ax, size=s, location=l, style="boxes", labels={"style":"major"}, 
 					bar={"projection":3857,"max":900,"major_div":3,"minor_div":1,"minor_type":"none"})
 
-# Resetting the sizes
-ScaleBar.set_size(size="sm")
+# No need to reset sizes - the size= parameter handles it per-call
 
 matplotlib.pyplot.savefig("./set_size.png", bbox_inches="tight")
 matplotlib.pyplot.close()
@@ -474,7 +471,7 @@ states.query("NAME=='Georgia'").plot(ax=ax)
 
 scale_bar(ax=ax, location="upper center", style="boxes", labels={"style":"major"}, 
             bar={"projection":3857,"max":500,"major_div":5,"minor_div":1,"minor_type":"none"}, 
-            aob={"bbox_to_anchor":(0.5,-0.01), "bbox_transform":ax.transAxes})
+            aob={"bbox_to_anchor":(0.5,-0.005), "bbox_transform":ax.transAxes})
 
 matplotlib.pyplot.savefig("./external_placement.png")
 matplotlib.pyplot.close()

{matplotlib_map_utils-4.0.0 → matplotlib_map_utils-4.1.0}/matplotlib_map_utils/__init__.py

@@ -10,12 +10,24 @@ __all__ = ["NorthArrow", "north_arrow",
            "InsetMap","inset_map", "ExtentIndicator","indicate_extent", "DetailIndicator","indicate_detail", "inset_usa",
            "set_size"]
 
+from . import config
+
 def set_size(size: Literal["xs","xsmall","x-small",
                            "sm","small",
                            "md","medium",
                            "lg","large",
                            "xl","xlarge","x-large"]):
-
-    NorthArrow.set_size(size)
-    ScaleBar.set_size(size)
-    InsetMap.set_size(size)
+    
+    # standardize the size string
+    size_map = {
+        "xs": "xs", "xsmall": "xs", "x-small": "xs",
+        "sm": "sm", "small": "sm",
+        "md": "md", "medium": "md",
+        "lg": "lg", "large": "lg",
+        "xl": "xl", "xlarge": "xl", "x-large": "xl"
+    }
+    
+    if size.lower() not in size_map:
+        raise ValueError("Invalid value supplied, try one of ['xsmall', 'small', 'medium', 'large', 'xlarge']")
+        
+    config.DEFAULT_SIZE = size_map[size.lower()]

matplotlib_map_utils-4.1.0/matplotlib_map_utils/config.py

@@ -0,0 +1,4 @@
+# Global configuration variables for matplotlib-map-utils
+
+# Default size used across all artists if no size is specified during initialization
+DEFAULT_SIZE = "md"