Skip to content

fmeffects

Model-Agnostic Interpretations with Forward Marginal Effects

v0.1.4 · Nov 5, 2024 · LGPL-3

Description

Create local, regional, and global explanations for any machine learning model with forward marginal effects. You provide a model and data, and 'fmeffects' computes feature effects. The package is based on the theory in: C. A. Scholbeck, G. Casalicchio, C. Molnar, B. Bischl, and C. Heumann (2022) <doi:10.48550/arXiv.2201.08837>.

Downloads

3.4K

Last 30 days

2076th

3.4K

Last 90 days

3.4K

Last year

CRAN Check Status

1 ERROR
13 OK
Show all 14 flavors
Flavor Status
r-devel-linux-x86_64-debian-clang OK
r-devel-linux-x86_64-debian-gcc OK
r-devel-linux-x86_64-fedora-clang OK
r-devel-linux-x86_64-fedora-gcc OK
r-devel-macos-arm64 ERROR
r-devel-windows-x86_64 OK
r-oldrel-macos-arm64 OK
r-oldrel-macos-x86_64 OK
r-oldrel-windows-x86_64 OK
r-patched-linux-x86_64 OK
r-release-linux-x86_64 OK
r-release-macos-arm64 OK
r-release-macos-x86_64 OK
r-release-windows-x86_64 OK
Check details (14 non-OK)
OK r-devel-linux-x86_64-debian-clang

*


            
OK r-devel-linux-x86_64-debian-gcc

*


            
OK r-devel-linux-x86_64-fedora-clang

*


            
OK r-devel-linux-x86_64-fedora-gcc

*


            
ERROR r-devel-macos-arm64

re-building of vignette outputs

Error(s) in re-building vignettes:
--- re-building ‘fme_theory.Rmd’ using rmarkdown
--- finished re-building ‘fme_theory.Rmd’

--- re-building ‘fmeffects.Rmd’ using rmarkdown

Quitting from fmeffects.Rmd:121-127 [unnamed-chunk-11]
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
<error/purrr_error_indexed>
Error:
ℹ In index: 1.
Caused by error in `.__Task__col_roles()`:
! Assertion on 'names(rhs)' failed: Names must be a permutation of set {'feature','target','name','order','stratum','group','offset','weights_learner','weights_measure'}, but has extra elements {'always_included'}.
---
Backtrace:
     ▆
  1. ├─parallel (local) workRSOCK()
  2. │ └─parallel:::workLoop(...)
  3. │   └─parallel:::workCommand(master)
  4. │     ├─base::tryCatch(...)
  5. │     │ └─base (local) tryCatchList(expr, classes, parentenv, handlers)
  6. │     │   └─base (local) tryCatchOne(expr, names, parentenv, handlers[[1L]])
  7. │     │     └─base (local) doTryCatch(return(expr), name, parentenv, handler)
  8. │     ├─base::tryCatch(...)
  9. │     │ └─base (local) tryCatchList(expr, classes, parentenv, handlers)
 10. │     │   └─base (local) tryCatchOne(expr, names, parentenv, handlers[[1L]])
 11. │     │     └─base (local) doTryCatch(return(expr), name, parentenv, handler)
 12. │     ├─base::do.call(msg$data$fun, msg$data$args, quote = TRUE)
 13. │     └─future (local) `<fn>`(base::quote(`<named list>`))
 14. │       ├─base::tryCatch(...)
 15. │       │ └─base (local) tryCatchList(expr, classes, parentenv, handlers)
 16. │       │   └─base (local) tryCatchOne(expr, names, parentenv, handlers[[1L]])
 17. │       │     └─base (local) doTryCatch(return(expr), name, parentenv, handler)
 18. │       └─future:::evalFutureInternal(data)
 19. │         ├─base::tryCatch(...)
 20. │         │ └─base (local) tryCatchList(expr, classes, parentenv, handlers)
 21. │         │   ├─base (local) tryCatchOne(...)
 22. │         │   │ └─base (local) doTryCatch(return(expr), name, parentenv, handler)
 23. │         │   └─base (local) tryCatchList(expr, names[-nh], parentenv, handlers[-nh])
 24. │         │     └─base (local) tryCatchOne(expr, names, parentenv, handlers[[1L]])
 25. │         │       └─base (local) doTryCatch(return(expr), name, parentenv, handler)
 26. │         ├─base::tryCatch(...)
 27. │         │ └─base (local) tryCatchList(expr, classes, parentenv, handlers)
 28. │         ├─base::withCallingHandlers(...)
 29. │         ├─base::withVisible(...)
 30. │         └─base::eval(expr, envir = globalenv())
 31. │           └─base::eval(expr, envir = globalenv())
 32. ├─base::local(...)
 33. │ └─base::eval.parent(substitute(eval(quote(expr), envir)))
 34. │   └─base::eval(expr, p)
 35. │     └─base::eval(expr, p)
 36. ├─base::eval(...)
 37. │ └─base::eval(...)
 38. │   ├─base::do.call(...furrr_map_fn, args)
 39. │   └─purrr (local) `<fn>`(.x = `<int>`, .f = `<fn>`)
 40. │     └─purrr:::map_("double", .x, .f, ..., .progress = .progress)
 41. │       ├─purrr:::with_indexed_errors(...)
 42. │       │ └─base::withCallingHandlers(...)
 43. │       ├─purrr:::call_with_cleanup(...)
 44. │       └─.f(.x[[i]], ...)
 45. │         └─fmeffects (local) ...furrr_fn(...)
 46. │           └─fmeffects (local) nlm_id(.x)
 47. │             └─NonLinearityMeasure$new(...)
 48. │               └─fmeffects (local) initialize(...)
 49. │                 └─private$nlmCompute(...)
 50. │                   └─fmeffects (local) simpson(prediction.s, subintervals)
 51. │                     └─fmeffects (local) f(0/s + m)
 52. │                       └─predictor$predict(observation.t)
 53. │                         ├─data.table::as.data.table(self$model$predict_newdata(newdata))
 54. │                         └─self$model$predict_newdata(newdata)
 55. │                           └─mlr3:::.__Learner__predict_newdata(...)
 56. └─mlr3 (local) `<fn>`(base::quote(`<named list>`))
 57.   └─mlr3:::.__Task__col_roles(...)
 58.     └─checkmate::assert_names(names(rhs), "unique", permutation.of = mlr_reflections$task_col_roles[[self$task_type]])
 59.       └─checkmate::makeAssertion(x, res, .var.name, add)
 60.         └─checkmate:::mstop(...)
 61.           └─base::stop(simpleError(sprintf(msg, ...), call.))
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

Error: processing vignette 'fmeffects.Rmd' failed with diagnostics:
ℹ In index: 1.
Caused by error in `.__Task__col_roles()`:
! Assertion on 'names(rhs)' failed: Names must be a permutation of set {'feature','target','name','order','stratum','group','offset','weights_learner','weights_measure'}, but has extra elements {'always_included'}.
--- failed re-building ‘fmeffects.Rmd’

SUMMARY: processing the following file failed:
  ‘fmeffects.Rmd’

Error: Vignette re-building failed.
Execution halted
OK r-devel-windows-x86_64

*


            
OK r-oldrel-macos-arm64

*


            
OK r-oldrel-macos-x86_64

*


            
OK r-oldrel-windows-x86_64

*


            
OK r-patched-linux-x86_64

*


            
OK r-release-linux-x86_64

*


            
OK r-release-macos-arm64

*


            
OK r-release-macos-x86_64

*


            
OK r-release-windows-x86_64

*


            

Check History

ERROR 13 OK · 0 NOTE · 0 WARNING · 1 ERROR · 0 FAILURE Mar 9, 2026
ERROR r-devel-macos-arm64

re-building of vignette outputs

Error(s) in re-building vignettes:
--- re-building ‘fme_theory.Rmd’ using rmarkdown
--- finished re-building ‘fme_theory.Rmd’

--- re-building ‘fmeffects.Rmd’ using rmarkdown

Quitting from fmeffects.Rmd:121-127 [unnamed-chunk-11]
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
<error/purrr_error_indexed>
Error:
ℹ In index: 1.
Caused by error in `.__Task__col_roles()`:
! Assertion on 'names(rhs)' failed: Names must be a permutation of set {'feature','target','nam

Reverse Dependencies (1)

suggests

Dependency Network

Dependencies Reverse dependencies checkmate cli data.table partykit ggparty ggplot2 cowplot R6 testthat marginaleffects fmeffects

Version History

new 0.1.4 Mar 9, 2026