+
Installation Channels
+
+
+
Stable Release (CRAN)
+
+
The default AMR Python package uses the latest stable
+version of the AMR R package, published on CRAN. After
+running pip install AMR, import it as usual:
+
import AMR
+
+AMR.example_isolates
+
+
+
Development Version (GitHub)
+
+
To use the latest development version of the AMR R
+package (sourced directly from GitHub), import the beta
+sub-package and alias it as AMR:
+
import AMR.beta as AMR
+
+AMR.example_isolates
+
Aliasing with as AMR keeps all downstream code identical
+to the stable import. Switching between the stable release and the
+development version requires changing only the import line — nothing
+else in your script needs to change.
+
+
+
SIR Classification with as_sir()
+
+
+
Using enforce_method
+
+
The as_sir() function in R uses S3 method dispatch to
+select the correct calculation method based on the input class:
+<mic> for MIC values and <disk>
+for disk diffusion values. Because Python objects do not carry R class
+attributes through the rpy2 bridge, this automatic dispatch
+may not resolve correctly.
+
To explicitly specify the input type, use the
+enforce_method argument:
+
# Treat the column as MIC values — maps to R's as.sir.mic()
+AMR.as_sir(df["MIC_col"], mo="E. coli", ab="AMX", guideline="EUCAST", enforce_method="mic")
+
+# Treat the column as disk diffusion values — maps to R's as.sir.disk()
+AMR.as_sir(df["disk_col"], mo="E. coli", ab="AMX", guideline="EUCAST", enforce_method="disk")
+
Without enforce_method, R falls back to class-based
+dispatch on the raw Python input, which may fail or return unexpected
+results. Always supply enforce_method when calling
+as_sir() from Python.
+
+
Conclusion
With the AMR Python package, Python users can now
diff --git a/articles/AMR_for_Python.md b/articles/AMR_for_Python.md
index 2ee907a0c..0d5f77ac8 100644
--- a/articles/AMR_for_Python.md
+++ b/articles/AMR_for_Python.md
@@ -200,6 +200,61 @@ AMR.antimicrobials
| ZID | 77846445.0 | Zidebactam | Other antibacterials | NaN | None | NaN | None |
| ZFD | NaN | Zoliflodacin | None | NaN | None | NaN | None |
+## Installation Channels
+
+### Stable Release (CRAN)
+
+The default `AMR` Python package uses the latest stable version of the
+`AMR` R package, published on CRAN. After running `pip install AMR`,
+import it as usual:
+
+``` python
+import AMR
+
+AMR.example_isolates
+```
+
+### Development Version (GitHub)
+
+To use the latest development version of the `AMR` R package (sourced
+directly from GitHub), import the `beta` sub-package and alias it as
+`AMR`:
+
+``` python
+import AMR.beta as AMR
+
+AMR.example_isolates
+```
+
+Aliasing with `as AMR` keeps all downstream code identical to the stable
+import. Switching between the stable release and the development version
+requires changing only the import line — nothing else in your script
+needs to change.
+
+## SIR Classification with `as_sir()`
+
+### Using `enforce_method`
+
+The `as_sir()` function in R uses S3 method dispatch to select the
+correct calculation method based on the input class: `` for MIC
+values and `` for disk diffusion values. Because Python objects do
+not carry R class attributes through the `rpy2` bridge, this automatic
+dispatch may not resolve correctly.
+
+To explicitly specify the input type, use the `enforce_method` argument:
+
+``` python
+# Treat the column as MIC values — maps to R's as.sir.mic()
+AMR.as_sir(df["MIC_col"], mo="E. coli", ab="AMX", guideline="EUCAST", enforce_method="mic")
+
+# Treat the column as disk diffusion values — maps to R's as.sir.disk()
+AMR.as_sir(df["disk_col"], mo="E. coli", ab="AMX", guideline="EUCAST", enforce_method="disk")
+```
+
+Without `enforce_method`, R falls back to class-based dispatch on the
+raw Python input, which may fail or return unexpected results. Always
+supply `enforce_method` when calling `as_sir()` from Python.
+
## Conclusion
With the `AMR` Python package, Python users can now effortlessly call R
diff --git a/articles/AMR_with_tidymodels.html b/articles/AMR_with_tidymodels.html
index a8d14fbca..d42739f72 100644
--- a/articles/AMR_with_tidymodels.html
+++ b/articles/AMR_with_tidymodels.html
@@ -30,7 +30,7 @@
AMR (for R)
- 3.0.1.9075
+ 3.0.1.9076
diff --git a/news/index.md b/news/index.md
index 763b09dda..b7e5ce260 100644
--- a/news/index.md
+++ b/news/index.md
@@ -1,6 +1,6 @@
# Changelog
-## AMR 3.0.1.9075
+## AMR 3.0.1.9076
Planned as v3.1.0, end of June 2026.
@@ -180,6 +180,9 @@ Planned as v3.1.0, end of June 2026.
the interpretation method when S3 class information is lost, e.g. when
called from Python
([\#291](https://github.com/msberends/AMR/issues/291))
+- `AMR for Python` vignette: added sections on installation channels
+ (stable CRAN vs. development GitHub via `AMR.beta`) and on using
+ `enforce_method` in `as_sir()` from Python
## AMR 3.0.1
diff --git a/pkgdown.yml b/pkgdown.yml
index a721e7698..250c4f1db 100644
--- a/pkgdown.yml
+++ b/pkgdown.yml
@@ -10,7 +10,7 @@ articles:
PCA: PCA.html
WHONET: WHONET.html
WISCA: WISCA.html
-last_built: 2026-06-26T10:08Z
+last_built: 2026-06-26T13:07Z
urls:
reference: https://amr-for-r.org/reference
article: https://amr-for-r.org/articles
diff --git a/reference/AMR-deprecated.html b/reference/AMR-deprecated.html
index 47688d6d1..f5e5f24be 100644
--- a/reference/AMR-deprecated.html
+++ b/reference/AMR-deprecated.html
@@ -7,7 +7,7 @@
AMR (for R)
-
3.0.1.9075
+
3.0.1.9076