maidr 1.9.0__tar.gz → 1.11.0__tar.gz

maidr-1.11.0/.github/workflows/claude.yml

@@ -0,0 +1,50 @@
+name: Claude Code
+
+on:
+  issue_comment:
+    types: [created]
+  pull_request_review_comment:
+    types: [created]
+  issues:
+    types: [opened, assigned]
+  pull_request_review:
+    types: [submitted]
+
+jobs:
+  claude:
+    if: |
+      (github.event_name == 'issue_comment' && contains(github.event.comment.body, '@claude')) ||
+      (github.event_name == 'pull_request_review_comment' && contains(github.event.comment.body, '@claude')) ||
+      (github.event_name == 'pull_request_review' && contains(github.event.review.body, '@claude')) ||
+      (github.event_name == 'issues' && (contains(github.event.issue.body, '@claude') || contains(github.event.issue.title, '@claude')))
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      pull-requests: read
+      issues: read
+      id-token: write
+      actions: read # Required for Claude to read CI results on PRs
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 1
+
+      - name: Run Claude Code
+        id: claude
+        uses: anthropics/claude-code-action@v1
+        with:
+          claude_code_oauth_token: ${{ secrets.CLAUDE_CODE_OAUTH_TOKEN }}
+
+          # This is an optional setting that allows Claude to read CI results on PRs
+          additional_permissions: |
+            actions: read
+
+          # Optional: Give a custom prompt to Claude. If this is not specified, Claude will perform the instructions specified in the comment that tagged it.
+          # prompt: 'Update the pull request description to include a summary of changes.'
+
+          # Optional: Add claude_args to customize behavior and configuration
+          # See https://github.com/anthropics/claude-code-action/blob/main/docs/usage.md
+          # or https://docs.claude.com/en/docs/claude-code/cli-reference for available options
+          # claude_args: '--allowed-tools Bash(gh pr:*)'
+

{maidr-1.9.0 → maidr-1.11.0}/CHANGELOG.md

@@ -1,6 +1,23 @@
 # CHANGELOG
 
 
+## v1.11.0 (2026-02-04)
+
+### Features
+
+- Include format configuration from plot api ([#262](https://github.com/xability/py-maidr/pull/262),
+  [`59eb82f`](https://github.com/xability/py-maidr/commit/59eb82f880d370eab4cf437e22dee3cd4856158c))
+
+
+## v1.10.0 (2026-01-31)
+
+### Features
+
+- Remove candlestick formatting and add ylabel to dodged plots
+  ([#260](https://github.com/xability/py-maidr/pull/260),
+  [`70b2626`](https://github.com/xability/py-maidr/commit/70b2626bb31e109e8cdb29051f809fe03bfb6275))
+
+
 ## v1.9.0 (2025-10-31)
 
 ### Features

{maidr-1.9.0 → maidr-1.11.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: maidr
-Version: 1.9.0
+Version: 1.11.0
 Summary: Multimodal Access and Interactive Data Representations
 Project-URL: Homepage, https://xability.github.io/py-maidr
 Project-URL: Repository, https://github.com/xability/py-maidr

{maidr-1.9.0 → maidr-1.11.0}/docs/examples.qmd

@@ -33,17 +33,18 @@ import maidr  #<<
 penguins = sns.load_dataset("penguins")
 
 # Create a bar plot showing the average body mass of penguins by species
-plt.figure(figsize=(6, 6))
+fig, ax = plt.subplots(figsize=(6, 6))
 
 # Assign the plot to a variable #<<
 bar_plot = sns.barplot(  #<<
-    x="species", y="body_mass_g", data=penguins, errorbar="sd", palette="Blues_d"
+    x="species", y="body_mass_g", data=penguins, errorbar="sd", palette="Blues_d", ax=ax
 )
-plt.title("Average Body Mass of Penguins by Species")
-plt.xlabel("Species")
-plt.ylabel("Body Mass (g)")
+ax.set_title("Average Body Mass of Penguins by Species")
+ax.set_xlabel("Species")
+ax.set_ylabel("Body Mass (g)")
 
-# plt.show()
+# Add number formatter for better screen reader output
+ax.yaxis.set_major_formatter("{x:,.0f}")
 
 # Use maidr.show() to display your plot #<<
 maidr.show(bar_plot)  #<<
@@ -65,14 +66,16 @@ import maidr #<<
 titanic = sns.load_dataset("titanic")
 
 # Create a count plot
-plt.figure(figsize=(6, 6))
-count_plot = sns.countplot(x="class", data=titanic, palette="viridis") #<<
+fig, ax = plt.subplots(figsize=(6, 6))
+count_plot = sns.countplot(x="class", data=titanic, palette="viridis", ax=ax) #<<
 
-plt.title("Passenger Class Distribution on the Titanic")
-plt.xlabel("Passenger Class")
-plt.ylabel("Count")
+ax.set_title("Passenger Class Distribution on the Titanic")
+ax.set_xlabel("Passenger Class")
+ax.set_ylabel("Count")
+
+# Add number formatter for better screen reader output
+ax.yaxis.set_major_formatter("{x:.0f}")
 
-# plt.show()
 maidr.show(count_plot) #<<
 ```
 
@@ -112,6 +115,9 @@ ax.set_ylabel("Average Body Mass")
 ax.set_title("Number of penguins with above average body mass")
 ax.legend(loc="upper right")
 
+# Add number formatter for better screen reader output
+ax.yaxis.set_major_formatter("{x:.0f}")
+
 maidr.show(p) #<<
 ```
 
@@ -152,9 +158,13 @@ for offset, (category, counts) in zip(offsets, weight_counts.items()):
 ax.set_xticks(x)
 ax.set_xticklabels(species)
 ax.set_xlabel("Species")
+ax.set_ylabel("Weight")
 ax.set_title("Dodged Bar Plot: Penguin Weight Counts")
 ax.legend(loc="upper right")
 
+# Add number formatter for better screen reader output
+ax.yaxis.set_major_formatter("{x:.0f}")
+
 # Show plot using maidr.show
 maidr.show(p) #<<
 ```
@@ -178,15 +188,18 @@ iris = sns.load_dataset("iris")
 petal_lengths = iris["petal_length"]
 
 # Plot a histogram of the petal lengths
-plt.figure(figsize=(6, 6))
+fig, ax = plt.subplots(figsize=(6, 6))
 
-hist_plot = sns.histplot(petal_lengths, kde=True, color="blue", binwidth=0.5) #<<
+hist_plot = sns.histplot(petal_lengths, kde=True, color="blue", binwidth=0.5, ax=ax) #<<
 
-plt.title("Petal Lengths in Iris Dataset")
-plt.xlabel("Petal Length (cm)")
-plt.ylabel("Frequency")
+ax.set_title("Petal Lengths in Iris Dataset")
+ax.set_xlabel("Petal Length (cm)")
+ax.set_ylabel("Frequency")
+
+# Add number formatters for better screen reader output
+ax.xaxis.set_major_formatter("{x:.1f}")
+ax.yaxis.set_major_formatter("{x:.0f}")
 
-# plt.show()
 maidr.show(hist_plot) #<<
 ```
 
@@ -207,14 +220,17 @@ np.random.seed(42)
 data = np.random.randn(500)
 
 # Create a KDE plot
-plt.figure(figsize=(6, 6))
-kde_plot = sns.kdeplot(data, fill=True, color="blue") #<<
+fig, ax = plt.subplots(figsize=(6, 6))
+kde_plot = sns.kdeplot(data, color="blue", ax=ax) #<<
 
-plt.title("KDE Plot of Random Data")
-plt.xlabel("Value")
-plt.ylabel("Density")
+ax.set_title("KDE Plot of Random Data")
+ax.set_xlabel("Value")
+ax.set_ylabel("Density")
+
+# Add number formatters for better screen reader output
+ax.xaxis.set_major_formatter("{x:.1f}")
+ax.yaxis.set_major_formatter("{x:.3f}")
 
-# plt.show()
 maidr.show(kde_plot) #<<
 ```
 
@@ -238,7 +254,7 @@ tips = sns.load_dataset("tips") #<<
 subset_data = tips[tips["day"] == "Thur"]
 
 # Create a line plot
-plt.figure(figsize=(6, 6))
+fig, ax = plt.subplots(figsize=(6, 6))
 line_plot = sns.lineplot( #<<
     data=subset_data,
     x="total_bill",
@@ -246,12 +262,16 @@ line_plot = sns.lineplot( #<<
     markers=True,
     style="day",
     legend=False,
+    ax=ax,
 )
-plt.title("Tips vs Total Bill (Thursday)")
-plt.xlabel("Total Bill")
-plt.ylabel("Tip")
+ax.set_title("Tips vs Total Bill (Thursday)")
+ax.set_xlabel("Total Bill")
+ax.set_ylabel("Tip")
+
+# Add currency formatters for better screen reader output
+ax.xaxis.set_major_formatter("${x:.2f}")
+ax.yaxis.set_major_formatter("${x:.2f}")
 
-# plt.show()
 maidr.show(line_plot) #<<
 ```
 
@@ -282,17 +302,21 @@ data = pd.DataFrame(
 )
 
 # Create the plot
-plt.figure(figsize=(6, 6))
+fig, ax = plt.subplots(figsize=(6, 6))
 
 # Use seaborn lineplot for multiple lines
 lineplot = sns.lineplot(
-    x="x", y="y", hue="series", style="series", markers=True, dashes=True, data=data
+    x="x", y="y", hue="series", style="series", markers=True, dashes=True, data=data, ax=ax
 )
 
 # Customize the plot
-plt.title("Seaborn Multiline Plot")
-plt.xlabel("X values")
-plt.ylabel("Y values")
+ax.set_title("Seaborn Multiline Plot")
+ax.set_xlabel("X values")
+ax.set_ylabel("Y values")
+
+# Add number formatters for better screen reader output
+ax.xaxis.set_major_formatter("{x:.0f}")
+ax.yaxis.set_major_formatter("{x:.0f}")
 
 # Display the plot using maidr
 maidr.show(lineplot) #<<
@@ -313,9 +337,14 @@ import maidr #<<
 glue = sns.load_dataset("glue").pivot(index="Model", columns="Task", values="Score")
 
 # Plot a heatmap
-plt.figure(figsize=(8, 8))
-heatmap = sns.heatmap(glue, annot=True, fill_label="Score") #<<
-plt.title("Model Scores by Task")
+fig, ax = plt.subplots(figsize=(8, 8))
+heatmap = sns.heatmap(glue, annot=True, fill_label="Score", ax=ax) #<<
+ax.set_title("Model Scores by Task")
+
+# Add number formatter for colorbar for better screen reader output
+cbar = heatmap.collections[0].colorbar
+if cbar:
+    cbar.ax.yaxis.set_major_formatter("{x:.1f}")
 
 # Show the plot
 # plt.show()
@@ -338,11 +367,14 @@ import maidr #<<
 iris = load_dataset("iris")
 
 # Create the horizontal boxplot
-horz_box_plot = sns.boxplot(x="petal_length", y="species", data=iris, orient="h") #<<
-plt.ylabel("Species")
-plt.xlabel("Petal Length")
-plt.title("Petal Length by Species from Iris Dataset")
-# plt.show()
+fig, ax = plt.subplots()
+horz_box_plot = sns.boxplot(x="petal_length", y="species", data=iris, orient="h", ax=ax) #<<
+ax.set_ylabel("Species")
+ax.set_xlabel("Petal Length (cm)")
+ax.set_title("Petal Length by Species from Iris Dataset")
+
+# Add number formatter for better screen reader output
+ax.xaxis.set_major_formatter("{x:.1f}")
 
 # Show the plot
 maidr.show(horz_box_plot) #<<
@@ -359,17 +391,21 @@ import seaborn as sns
 import maidr #<<
 
 # Create a scatter plot
+fig, ax = plt.subplots()
 scatter_plot = sns.scatterplot( #<<
-    data=iris, x="sepal_length", y="sepal_width", hue="species"
+    data=iris, x="sepal_length", y="sepal_width", hue="species", ax=ax
 )
 
-# Adding title and labels (optional)
-plt.title("Iris Sepal Length vs Sepal Width")
-plt.xlabel("Sepal Length")
-plt.ylabel("Sepal Width")
+# Adding title and labels
+ax.set_title("Iris Sepal Length vs Sepal Width")
+ax.set_xlabel("Sepal Length (cm)")
+ax.set_ylabel("Sepal Width (cm)")
+
+# Add number formatters for better screen reader output
+ax.xaxis.set_major_formatter("{x:.1f}")
+ax.yaxis.set_major_formatter("{x:.1f}")
 
 # Show the plot
-# plt.show()
 maidr.show(scatter_plot) #<<
 ```
 
@@ -391,19 +427,23 @@ x = np.linspace(0, 10, 50)
 y = 2 * x + 1 + np.random.normal(0, 2, 50)
 
 # Create a regression plot
-plt.figure(figsize=(6, 6))
+fig, ax = plt.subplots(figsize=(6, 6))
 reg_plot = sns.regplot(
     x=x,
     y=y,
     scatter_kws={"s": 50, "alpha": 0.7},
     line_kws={"color": "red", "lw": 2},
+    ax=ax,
 ) #<<
 
-plt.title("Regression Plot with Fitted Line")
-plt.xlabel("X values")
-plt.ylabel("Y values")
+ax.set_title("Regression Plot with Fitted Line")
+ax.set_xlabel("X values")
+ax.set_ylabel("Y values")
+
+# Add number formatters for better screen reader output
+ax.xaxis.set_major_formatter("{x:.1f}")
+ax.yaxis.set_major_formatter("{x:.2f}")
 
-# plt.show()
 maidr.show(reg_plot) #<<
 ```
 
@@ -447,6 +487,11 @@ lines1, labels1 = ax1.get_legend_handles_labels()
 lines2, labels2 = ax2.get_legend_handles_labels()
 ax1.legend(lines1 + lines2, labels1 + labels2, loc="upper left")
 
+# Add number formatters for better screen reader output
+ax1.xaxis.set_major_formatter("{x:.0f}")
+ax1.yaxis.set_major_formatter("{x:.0f}")
+ax2.yaxis.set_major_formatter("{x:.0f}")
+
 # Adjust layout
 fig.tight_layout()
 
@@ -507,6 +552,12 @@ axs[2].set_title("Bar Plot 2: Random Values")  # Fixed the typo in the title
 axs[2].set_xlabel("Categories")
 axs[2].set_ylabel("Values")
 
+# Add number formatters for better screen reader output
+axs[0].xaxis.set_major_formatter("{x:.0f}")
+axs[0].yaxis.set_major_formatter("{x:.0f}")
+axs[1].yaxis.set_major_formatter("{x:.1f}")
+axs[2].yaxis.set_major_formatter("{x:.1f}")
+
 # Adjust layout to prevent overlap
 plt.tight_layout()
 
@@ -566,6 +617,10 @@ fig.text(
 # Add a common title
 fig.suptitle("Facet Plot: Bar Charts by Condition", fontsize=16)
 
+# Add number formatters for better screen reader output
+for ax in axs:
+    ax.yaxis.set_major_formatter("{x:.1f}")
+
 # Adjust layout
 plt.tight_layout(rect=(0.08, 0.08, 0.98, 0.95))
 
@@ -580,6 +635,7 @@ maidr.show(fig) #<<
 
 import mplfinance as mpf
 import pandas as pd
+import matplotlib.dates as mdates
 
 import maidr #<<
 
@@ -587,17 +643,26 @@ import maidr #<<
 daily = pd.read_csv("../example/candle_stick/volcandat.csv", index_col=0, parse_dates=True)
 
 # Create the candlestick chart with moving averages and volume
-fig, ax = mpf.plot(
+fig, axlist = mpf.plot(
     daily,
     type="candle",
     volume=True,
     mav = (3,6,9),
     returnfig=True,
-    ylabel="Price ($)",
+    ylabel="Price",
     ylabel_lower="Volume",
     xlabel="Date",
     title="Stock Price with Volume",
 )  #<<
+
+# Add formatters for better screen reader output
+# Price axis - Currency format
+axlist[0].yaxis.set_major_formatter("${x:,.2f}")
+# Date axis - Custom date format like "Nov 18, 2016"
+axlist[0].xaxis.set_major_formatter(mdates.DateFormatter("%b %d, %Y"))
+# Volume axis - Integer with thousands separator
+axlist[2].yaxis.set_major_formatter("{x:,.0f}")
+
 fig.tight_layout()
 
 # Display with maidr

{maidr-1.9.0 → maidr-1.11.0}/example/bar/example_bar_plot.ipynb

@@ -19,7 +19,7 @@
   },
   {
    "cell_type": "code",
-   "execution_count": 1,
+   "execution_count": null,
    "metadata": {},
    "outputs": [
     {
@@ -48,29 +48,32 @@
     }
    ],
    "source": [
-    "\n",
     "import matplotlib.pyplot as plt\n",
-    "import maidr\n",
     "import seaborn as sns\n",
     "\n",
+    "import maidr\n",
+    "\n",
     "# Load dataset\n",
     "tips = sns.load_dataset(\"tips\")\n",
     "\n",
     "# Create a bar plot\n",
     "cut_counts = tips[\"day\"].value_counts()\n",
-    "plt.figure(figsize=(10, 6))\n",
-    "b_plot = plt.bar(cut_counts.index, list(cut_counts.values), color=\"skyblue\")\n",
-    "plt.title(\"The Number of Tips by Day\")\n",
-    "plt.xlabel(\"Day\")\n",
-    "plt.ylabel(\"Count\")\n",
+    "fig, ax = plt.subplots(figsize=(10, 6))\n",
+    "b_plot = ax.bar(cut_counts.index, list(cut_counts.values), color=\"skyblue\")\n",
+    "ax.set_title(\"The Number of Tips by Day\")\n",
+    "ax.set_xlabel(\"Day\")\n",
+    "ax.set_ylabel(\"Count\")\n",
+    "\n",
+    "# Add number formatter to y-axis for better screen reader output\n",
+    "# This formats values with no decimal places (integer counts)\n",
+    "ax.yaxis.set_major_formatter(\"{x:.2f}\")\n",
     "\n",
-    "# plt.show()\n",
-    "maidr.show(b_plot)"
+    "maidr.show(b_plot)\n"
    ]
   },
   {
    "cell_type": "code",
-   "execution_count": 5,
+   "execution_count": null,
    "metadata": {},
    "outputs": [
     {
@@ -91,22 +94,26 @@
    ],
    "source": [
     "import matplotlib.pyplot as plt\n",
-    "import maidr\n",
     "import seaborn as sns\n",
     "\n",
+    "import maidr\n",
+    "\n",
     "# Load the penguins dataset\n",
     "penguins = sns.load_dataset(\"penguins\")\n",
     "\n",
     "# Create a bar plot showing the average body mass of penguins by species\n",
-    "plt.figure(figsize=(10, 6))\n",
+    "fig, ax = plt.subplots(figsize=(10, 6))\n",
     "b_plot = sns.barplot(\n",
-    "    x=\"species\", y=\"body_mass_g\", data=penguins, errorbar=\"sd\", palette=\"Blues_d\"\n",
+    "    x=\"species\", y=\"body_mass_g\", data=penguins, errorbar=\"sd\", palette=\"Blues_d\", ax=ax\n",
     ")\n",
-    "plt.title(\"Average Body Mass of Penguins by Species\")\n",
-    "plt.xlabel(\"Species\")\n",
-    "plt.ylabel(\"Body Mass (g)\")\n",
+    "ax.set_title(\"Average Body Mass of Penguins by Species\")\n",
+    "ax.set_xlabel(\"Species\")\n",
+    "ax.set_ylabel(\"Body Mass (g)\")\n",
+    "\n",
+    "# Add number formatter to y-axis for better screen reader output\n",
+    "# Body mass values with thousands separator (e.g., \"4,500\")\n",
+    "ax.yaxis.set_major_formatter(\"{x:,.0f}\")\n",
     "\n",
-    "# plt.show()\n",
     "maidr.show(b_plot)\n"
    ]
   },

maidr-1.11.0/example/bar/matplotlib/example_mpl_bar_plot.py

@@ -0,0 +1,21 @@
+import matplotlib.pyplot as plt
+import seaborn as sns
+
+import maidr
+
+# Load dataset
+tips = sns.load_dataset("tips")
+
+# Create a bar plot
+cut_counts = tips["day"].value_counts()
+fig, ax = plt.subplots(figsize=(10, 6))
+b_plot = ax.bar(cut_counts.index, list(cut_counts.values), color="skyblue")
+ax.set_title("The Number of Tips by Day")
+ax.set_xlabel("Day")
+ax.set_ylabel("Count")
+
+# Add number formatter to y-axis for better screen reader output
+# This formats values with no decimal places (integer counts)
+ax.yaxis.set_major_formatter("{x:.2f}")
+
+maidr.show(b_plot)

maidr-1.11.0/example/bar/seaborn/example_sns_bar_plot.py

@@ -0,0 +1,22 @@
+import matplotlib.pyplot as plt
+import seaborn as sns
+
+import maidr
+
+# Load the penguins dataset
+penguins = sns.load_dataset("penguins")
+
+# Create a bar plot showing the average body mass of penguins by species
+fig, ax = plt.subplots(figsize=(10, 6))
+b_plot = sns.barplot(
+    x="species", y="body_mass_g", data=penguins, errorbar="sd", palette="Blues_d", ax=ax
+)
+ax.set_title("Average Body Mass of Penguins by Species")
+ax.set_xlabel("Species")
+ax.set_ylabel("Body Mass (g)")
+
+# Add number formatter to y-axis for better screen reader output
+# Body mass values with thousands separator (e.g., "4,500")
+ax.yaxis.set_major_formatter("{x:,.0f}")
+
+maidr.show(b_plot)