{ "_id": "6a1eb52eb25058d4daadd8d4", "Package": "proxymix", "Type": "Package", "Title": "KL-Optimal Gaussian Mixture Proxies for Arbitrary Target\nDensities", "Version": "0.3.0", "Authors@R": "c(\nperson(given = \"Max\",\nfamily = \"Moldovan\",\nrole = c(\"aut\", \"cre\"),\nemail = \"max.moldovan@gmail.com\",\ncomment = c(ORCID = \"0000-0001-9680-8474\")),\nperson(given = \"Johannes\",\nfamily = \"van der Hoek\",\nrole = \"ctb\",\ncomment = \"Foundational theory in Hoek & Elliott (2024).\"),\nperson(given = \"Robert J.\",\nfamily = \"Elliott\",\nrole = \"ctb\",\ncomment = \"Foundational theory in Hoek & Elliott (2024).\"))", "Description": "Fits multivariate Gaussian-mixture proxies that are\nKullback-Leibler optimal to user-supplied target densities on\nreal Euclidean space. Three fitting regimes are unified under\none verb: (i) closed-form moment matching for a single\ncomponent, (ii) classical expectation-maximisation when\nindependent samples are available, and (iii) importance-sampled\nKLD-EM when the target can be evaluated point-wise but not\n(cheaply) sampled. Closed-form Gaussian-mixture operators\n(density, sampling, marginalisation, conditioning, divergence)\nround out the toolkit. Implements the regime hierarchy of Hoek\nand Elliott (2024) .", "License": "MIT + file LICENSE", "URL": "https://github.com/max578/proxymix", "BugReports": "https://github.com/max578/proxymix/issues", "Encoding": "UTF-8", "Language": "en-AU", "VignetteBuilder": "knitr", "RoxygenNote": "7.3.3", "Roxygen": "list(markdown = TRUE)", "Config/testthat/edition": "3", "Config/testthat/parallel": "true", "Repository": "https://max578.r-universe.dev", "Date/Publication": "2026-06-02 06:03:30 UTC", "RemoteUrl": "https://github.com/max578/proxymix", "RemoteRef": "main", "RemoteSha": "51d879b0d12f318671ddaa530d2b5cd1a20bcd97", "NeedsCompilation": "no", "Packaged": { "Date": "2026-06-02 10:24:49 UTC", "User": "root" }, "Author": "Max Moldovan [aut, cre] (ORCID:\n),\nJohannes van der Hoek [ctb] (Foundational theory in Hoek & Elliott\n(2024).),\nRobert J. Elliott [ctb] (Foundational theory in Hoek & Elliott (2024).)", "Maintainer": "Max Moldovan ", "MD5sum": "235d28f828427d004969cde14a4271d8", "_user": "max578", "_type": "src", "_file": "proxymix_0.3.0.tar.gz", "_fileid": "d173bd3c1ebf07c91f90cdcbf78d3554d6a0988d71ef9fdba1ae2d2a3010aa60", "_filesize": 1419862, "_sha256": "d173bd3c1ebf07c91f90cdcbf78d3554d6a0988d71ef9fdba1ae2d2a3010aa60", "_created": "2026-06-02T10:24:49.000Z", "_published": "2026-06-02T10:49:17.970Z", "_distro": "noble", "_jobs": [ { "job": 79050160092, "time": 159, "config": "linux-devel-x86_64", "r": "4.7.0", "check": "OK", "artifact": "7355204205" }, { "job": 79050160450, "time": 160, "config": "linux-release-x86_64", "r": "4.6.0", "check": "OK", "artifact": "7355204522" }, { "job": 79050160397, "time": 94, "config": "macos-oldrel-arm64", "r": "4.5.3", "check": "OK", "artifact": "7355223663" }, { "job": 79050160059, "time": 89, "config": "macos-release-arm64", "r": "4.6.0", "check": "OK", "artifact": "7355211872" }, { "job": 79049588228, "time": 214, "config": "source", "r": "4.6.0", "check": "OK", "artifact": "7355150613" }, { "job": 79050160030, "time": 1427, "config": "wasm-release", "r": "4.6.0", "check": "FAIL", "artifact": "" }, { "job": 79050160328, "time": 108, "config": "windows-devel", "r": "4.7.0", "check": "OK", "artifact": "7355187974" }, { "job": 79050160056, "time": 116, "config": "windows-oldrel", "r": "4.5.3", "check": "OK", "artifact": "7355190473" }, { "job": 79050160415, "time": 106, "config": "windows-release", "r": "4.6.0", "check": "OK", "artifact": "7355187520" } ], "_buildurl": "https://github.com/r-universe/max578/actions/runs/26813574484", "_status": "success", "_host": "GitHub-Actions", "_upstream": "https://github.com/max578/proxymix", "_commit": { "id": "51d879b0d12f318671ddaa530d2b5cd1a20bcd97", "author": "Max Moldovan ", "committer": "Max Moldovan ", "message": "feat: add autoplot() method for gmm_fit\n\nRender a fitted Gaussian-mixture proxy with ggplot2 -- a marginal density\ncurve in one dimension, or a viridis density raster with per-component\nellipses in two. Any ambient dimension is reduced to the requested\ncoordinates through the package own closed-form gmm_marginalise().\n\nggplot2 stays an optional dependency: the method registers against\nggplot2 S3 autoplot generic at load only when ggplot2 is installed\n(S7 objects carry a package-prefixed S3 class), so R CMD check stays\nclean with no sibling installed. Check 0E/0W/0N; 11 new tests.\n", "time": 1780380210 }, "_maintainer": { "name": "Max Moldovan", "email": "max.moldovan@gmail.com", "login": "max578", "orcid": "0000-0001-9680-8474", "description": "Research scientist, R&D translation professional, woking on practical impact applications in agriculture, healthcare/madicine and good-practices-AI education.", "uuid": 35710829 }, "_registered": true, "_dependencies": [ { "package": "R", "version": ">= 4.3", "role": "Depends" }, { "package": "S7", "role": "Imports" }, { "package": "stats", "role": "Imports" }, { "package": "mvnfast", "role": "Imports" }, { "package": "cli", "role": "Imports" }, { "package": "rlang", "role": "Imports" }, { "package": "mclust", "role": "Suggests" }, { "package": "ggplot2", "role": "Suggests" }, { "package": "viridis", "role": "Suggests" }, { "package": "patchwork", "role": "Suggests" }, { "package": "withr", "role": "Suggests" }, { "package": "knitr", "role": "Suggests" }, { "package": "rmarkdown", "role": "Suggests" }, { "package": "testthat", "version": ">= 3.0.0", "role": "Suggests" }, { "package": "vdiffr", "role": "Suggests" }, { "package": "spelling", "role": "Suggests" }, { "package": "covr", "role": "Suggests" } ], "_owner": "max578", "_selfowned": true, "_usedby": 0, "_updates": [ { "week": "2026-20", "n": 4 }, { "week": "2026-23", "n": 1 } ], "_tags": [ { "name": "v0.3.0", "date": "2026-05-15" } ], "_stars": 0, "_contributors": [ { "user": "max578", "count": 5, "uuid": 35710829 } ], "_userbio": { "uuid": 35710829, "type": "user", "name": "Max Moldovan", "description": "Research scientist, R&D translation professional, woking on practical impact applications in agriculture, healthcare/madicine and good-practices-AI education." }, "_downloads": { "count": 0, "source": "https://cranlogs.r-pkg.org/downloads/total/last-month/proxymix" }, "_devurl": "https://github.com/max578/proxymix", "_searchresults": 0, "_rbuild": "4.6.0", "_assets": [ "extra/citation.cff", "extra/citation.html", "extra/citation.json", "extra/citation.txt", "extra/contents.json", "extra/NEWS.html", "extra/NEWS.txt", "extra/proxymix.html", "extra/readme.html", "extra/readme.md", "manual.pdf" ], "_cranurl": false, "_exports": [ "banana_target", "bic_aic", "dgmm", "donut_target", "ess_summary", "ess_trace", "fit_em_samples", "fit_kld_em", "fit_kld_em_collider", "fit_moment_match", "fit_proxymix", "from_aggregate_likelihood", "from_kde", "from_simulator", "gmm", "gmm_affine", "gmm_aggregate", "gmm_canonicalise", "gmm_conditionalise", "gmm_dim", "gmm_fit", "gmm_kld", "gmm_marginalise", "gmm_missing", "gmm_n_components", "gmm_observe", "gmm_target", "gmm_target_from_posterior", "gmm_target_from_samples", "hellinger_mc", "init_kmeans", "init_moment_seed", "init_random", "init_warm_start", "is_mvn", "is_mvt", "is_proposal", "is_uniform", "kld_trace", "mixture_target", "multi_start_best_of", "rgmm", "to_apsim_scenarios" ], "_help": [ { "page": "autoplot.gmm_fit", "title": "Plot a fitted Gaussian-mixture proxy", "concept": [ "classes" ], "topics": [ "autoplot.gmm_fit" ] }, { "page": "banana_target", "title": "Banana-shaped 2-D target", "concept": [ "targets" ], "topics": [ "banana_target" ] }, { "page": "bic_aic", "title": "Bayesian and Akaike information criteria", "concept": [ "diagnostics" ], "topics": [ "bic_aic" ] }, { "page": "dgmm", "title": "Density of a Gaussian mixture", "concept": [ "ops" ], "topics": [ "dgmm" ] }, { "page": "donut_target", "title": "Donut-shaped 2-D target", "concept": [ "targets" ], "topics": [ "donut_target" ] }, { "page": "ess_summary", "title": "Summary of importance-sampling diagnostics", "concept": [ "diagnostics" ], "topics": [ "ess_summary" ] }, { "page": "ess_trace", "title": "Effective sample size of the importance-sampling weights", "concept": [ "diagnostics" ], "topics": [ "ess_trace" ] }, { "page": "fit_em_samples", "title": "Classical EM fit on samples", "concept": [ "fitting" ], "topics": [ "fit_em_samples" ] }, { "page": "fit_kld_em", "title": "Importance-sampled KLD-EM fit (the wedge)", "concept": [ "fitting" ], "topics": [ "fit_kld_em" ] }, { "page": "fit_kld_em_collider", "title": "KLD-EM under collider-induced conditional-independence constraints (stub)", "concept": [ "stubs" ], "topics": [ "fit_kld_em_collider" ] }, { "page": "fit_moment_match", "title": "Closed-form moment-matching fit", "concept": [ "fitting" ], "topics": [ "fit_moment_match" ] }, { "page": "fit_proxymix", "title": "Fit a Gaussian-mixture proxy to a target density", "concept": [ "interface" ], "topics": [ "fit_proxymix" ] }, { "page": "from_aggregate_likelihood", "title": "From an aggregate likelihood to a Gaussian-mixture proxy (stub)", "concept": [ "stubs" ], "topics": [ "from_aggregate_likelihood" ] }, { "page": "from_kde", "title": "Compile a kernel-density estimate into a Gaussian-mixture proxy", "concept": [ "fitting", "v0_2" ], "topics": [ "from_kde" ] }, { "page": "from_simulator", "title": "Wrap an expensive simulator as a 'gmm_target' (stub)", "concept": [ "stubs" ], "topics": [ "from_simulator" ] }, { "page": "gmm", "title": "A Gaussian mixture", "concept": [ "classes" ], "topics": [ "gmm" ] }, { "page": "gmm_affine", "title": "Affine pushforward of a Gaussian mixture", "concept": [ "operators", "v0_3" ], "topics": [ "gmm_affine" ] }, { "page": "gmm_aggregate", "title": "Aggregation pushforward of a Gaussian mixture", "concept": [ "operators", "v0_3" ], "topics": [ "gmm_aggregate" ] }, { "page": "gmm_canonicalise", "title": "Canonicalise the component ordering of a Gaussian mixture", "concept": [ "ops" ], "topics": [ "gmm_canonicalise" ] }, { "page": "gmm_conditionalise", "title": "Conditional of a Gaussian mixture", "concept": [ "ops" ], "topics": [ "gmm_conditionalise" ] }, { "page": "gmm_dim", "title": "Dimension of a Gaussian mixture", "concept": [ "classes" ], "topics": [ "gmm_dim" ] }, { "page": "gmm_fit", "title": "A fitted Gaussian-mixture proxy", "concept": [ "classes" ], "topics": [ "gmm_fit" ] }, { "page": "gmm_kld", "title": "Kullback-Leibler divergence between two Gaussian mixtures", "concept": [ "ops" ], "topics": [ "gmm_kld" ] }, { "page": "gmm_marginalise", "title": "Marginal of a Gaussian mixture", "concept": [ "ops" ], "topics": [ "gmm_marginalise" ] }, { "page": "gmm_missing", "title": "Condition a Gaussian mixture on the exact values of some coordinates", "concept": [ "operators", "v0_3" ], "topics": [ "gmm_missing" ] }, { "page": "gmm_n_components", "title": "Number of components in a Gaussian mixture", "concept": [ "classes" ], "topics": [ "gmm_n_components" ] }, { "page": "gmm_observe", "title": "Bayesian update of a Gaussian mixture on a noisy linear observation", "concept": [ "operators", "v0_3" ], "topics": [ "gmm_observe" ] }, { "page": "gmm_target", "title": "A target density on R^p", "concept": [ "classes" ], "topics": [ "gmm_target" ] }, { "page": "gmm_target_from_posterior", "title": "Compile an unnormalised Bayesian posterior into a 'gmm_target'", "concept": [ "interop", "v0_2" ], "topics": [ "gmm_target_from_posterior", "gmm_target_from_posterior.default", "gmm_target_from_posterior.function" ] }, { "page": "gmm_target_from_samples", "title": "Build a target from samples alone", "concept": [ "targets" ], "topics": [ "gmm_target_from_samples" ] }, { "page": "hellinger_mc", "title": "Monte-Carlo Hellinger distance between a fit and its target", "concept": [ "diagnostics" ], "topics": [ "hellinger_mc" ] }, { "page": "init_kmeans", "title": "k-means initialisation", "concept": [ "init" ], "topics": [ "init_kmeans" ] }, { "page": "init_moment_seed", "title": "Moment-seed initialisation", "concept": [ "init" ], "topics": [ "init_moment_seed" ] }, { "page": "init_random", "title": "Random initialisation", "concept": [ "init" ], "topics": [ "init_random" ] }, { "page": "init_warm_start", "title": "Warm-start initialisation from an existing fit", "concept": [ "init" ], "topics": [ "init_warm_start" ] }, { "page": "is_mvn", "title": "Multivariate-normal proposal", "concept": [ "proposals" ], "topics": [ "is_mvn" ] }, { "page": "is_mvt", "title": "Multivariate-t proposal", "concept": [ "proposals" ], "topics": [ "is_mvt" ] }, { "page": "is_proposal", "title": "An importance-sampling proposal", "concept": [ "classes" ], "topics": [ "is_proposal" ] }, { "page": "is_uniform", "title": "Uniform-on-a-box proposal", "concept": [ "proposals" ], "topics": [ "is_uniform" ] }, { "page": "kld_trace", "title": "Per-iteration KLD trace of a fit", "concept": [ "diagnostics" ], "topics": [ "kld_trace" ] }, { "page": "mixture_target", "title": "Three-component Gaussian-mixture target", "concept": [ "targets" ], "topics": [ "mixture_target" ] }, { "page": "multi_start_best_of", "title": "Multi-start best-of wrapper", "concept": [ "init" ], "topics": [ "multi_start_best_of" ] }, { "page": "rgmm", "title": "Sample from a Gaussian mixture", "concept": [ "ops" ], "topics": [ "rgmm" ] }, { "page": "to_apsim_scenarios", "title": "Gaussian-mixture samples to APSIM scenario tables (stub)", "concept": [ "stubs" ], "topics": [ "to_apsim_scenarios" ] } ], "_readme": "https://github.com/max578/proxymix/raw/main/README.md", "_rundeps": [ "BH", "cli", "mvnfast", "Rcpp", "RcppArmadillo", "rlang", "S7" ], "_vignettes": [ { "source": "operator_calculus.Rmd", "filename": "operator_calculus.html", "title": "Affine-Gaussian operator calculus on a Gaussian mixture", "engine": "knitr::rmarkdown", "headings": [ "Why an operator calculus", "A worked example", "Pushforward through a linear sensor", "Bayesian update on a noisy linear observation", "Kalman parity check", "Aggregation through a coarsening matrix", "Missing-data conditioning", "Composition rules", "When to not use the operator calculus", "Comparison to a Gaussian-process latent", "References" ], "created": "2026-05-14 08:05:40", "modified": "2026-05-14 08:05:40", "commits": 1 }, { "source": "from_kde.Rmd", "filename": "from_kde.html", "title": "From KDE: compressing a kernel density estimate into a Gaussian-mixture proxy", "engine": "knitr::rmarkdown", "headings": [ "Why a from_kde() constructor", "Recovering a known mixture", "Quality of the importance-sampled fit", "Bandwidth sensitivity", "Visualising the compression", "Scope and limits (v0.2)", "When to prefer fit_proxymix(regime = \"sample\") instead", "References" ], "created": "2026-05-14 08:05:40", "modified": "2026-05-14 08:05:40", "commits": 1 }, { "source": "quickstart.Rmd", "filename": "quickstart.html", "title": "Quickstart", "engine": "knitr::rmarkdown", "headings": [ "A target you cannot sample from", "Fit a Gaussian-mixture proxy", "Overlay the proxy on the target", "Closed-form mixture operations", "Where to next", "Reference" ], "created": "2026-05-14 08:05:40", "modified": "2026-05-14 08:05:40", "commits": 1 }, { "source": "density_shapes.Rmd", "filename": "density_shapes.html", "title": "The wedge: KLD-EM on three density shapes", "engine": "knitr::rmarkdown", "headings": [ "Banana", "Donut", "Three-mixture", "Summary", "Reference" ], "created": "2026-05-14 08:05:40", "modified": "2026-05-14 08:05:40", "commits": 1 }, { "source": "three_regimes.Rmd", "filename": "three_regimes.html", "title": "Three regimes: moment, sample, and KLD-EM", "engine": "knitr::rmarkdown", "headings": [ "Regime (i): closed-form moment matching", "Regime (ii): classical EM on samples", "Regime (iii): importance-sampled KLD-EM — the wedge", "Side-by-side overlay", "A sanity check: (i) and (iii) agree at N = 1", "Reference" ], "created": "2026-05-14 08:05:40", "modified": "2026-05-14 08:05:40", "commits": 1 }, { "source": "roadmap.Rmd", "filename": "roadmap.html", "title": "Tier-2 stubs: the research roadmap", "engine": "knitr::rmarkdown", "headings": [ "What the stubs are for", "from_kde() — KDE to Gaussian-mixture proxy (graduated in v0.2.0)", "from_aggregate_likelihood() — kernel-downsizing integration", "fit_kld_em_collider() — DAG-constrained KLD-EM", "to_apsim_scenarios() — APSIM scenario generation", "from_simulator() — wrap an expensive simulator as a target", "Why these stubs and not others", "What is not coming", "Reference" ], "created": "2026-05-14 08:05:40", "modified": "2026-05-14 08:05:40", "commits": 1 } ], "_score": 3.778151250383644, "_indexed": true, "_nocasepkg": "proxymix", "_universes": [ "max578" ], "_binaries": [ { "r": "4.6.0", "os": "wasm", "version": "0.3.0", "date": "2026-05-22T01:28:18.000Z", "commit": "138485ae766a20a8b1363f1be528ba68374b6146", "fileid": "bc3e2c8a46e012919f06675fc870bd764dd5dffc4f4e758c05ffa76d5378f93f", "status": "success", "buildurl": "https://github.com/r-universe/max578/actions/runs/26065365390" }, { "r": "4.7.0", "os": "linux", "version": "0.3.0", "date": "2026-06-02T10:27:19.000Z", "distro": "noble", "commit": "51d879b0d12f318671ddaa530d2b5cd1a20bcd97", "fileid": "f24a0ce2c98c20e66d375e789830dffc75ac73aed90d16fe3c6a23c221141e89", "status": "success", "check": "OK", "buildurl": "https://github.com/r-universe/max578/actions/runs/26813574484" }, { "r": "4.6.0", "os": "linux", "version": "0.3.0", "date": "2026-06-02T10:27:22.000Z", "distro": "noble", "commit": "51d879b0d12f318671ddaa530d2b5cd1a20bcd97", "fileid": "812b25d37f4bcc80af9a3cf5120bceb36aeb1f7d25b88d7f1998dc13a1e1d154", "status": "success", "check": "OK", "buildurl": "https://github.com/r-universe/max578/actions/runs/26813574484" }, { "r": "4.5.3", "os": "mac", "version": "0.3.0", "date": "2026-06-02T10:28:32.000Z", "commit": "51d879b0d12f318671ddaa530d2b5cd1a20bcd97", "fileid": "87a2537e9320e3530a940ac87328c188ce0622c04970bb3dcf1861b22a0b9e39", "status": "success", "check": "OK", "buildurl": "https://github.com/r-universe/max578/actions/runs/26813574484" }, { "r": "4.6.0", "os": "mac", "version": "0.3.0", "date": "2026-06-02T10:27:57.000Z", "commit": "51d879b0d12f318671ddaa530d2b5cd1a20bcd97", "fileid": "334aeb9120f81280d18e7f151244a3220464fa7a3137fccdd888527dd496789a", "status": "success", "check": "OK", "buildurl": "https://github.com/r-universe/max578/actions/runs/26813574484" }, { "r": "4.7.0", "os": "win", "version": "0.3.0", "date": "2026-06-02T10:26:22.000Z", "commit": "51d879b0d12f318671ddaa530d2b5cd1a20bcd97", "fileid": "315474a790796bf5926a7703a17a357827c52c2e07174928f722c2f5183ca3a5", "status": "success", "check": "OK", "buildurl": "https://github.com/r-universe/max578/actions/runs/26813574484" }, { "r": "4.5.3", "os": "win", "version": "0.3.0", "date": "2026-06-02T10:26:27.000Z", "commit": "51d879b0d12f318671ddaa530d2b5cd1a20bcd97", "fileid": "ff7c0d07d61a6dc71be59fcdc06a3e00f69dddb948388b0d0fb846dedd571fbf", "status": "success", "check": "OK", "buildurl": "https://github.com/r-universe/max578/actions/runs/26813574484" }, { "r": "4.6.0", "os": "win", "version": "0.3.0", "date": "2026-06-02T10:26:19.000Z", "commit": "51d879b0d12f318671ddaa530d2b5cd1a20bcd97", "fileid": "f65e0bf22ae9821e9c033b9f9aa31ba4dfa0aeb9ce7e4377e035ac943a989c75", "status": "success", "check": "OK", "buildurl": "https://github.com/r-universe/max578/actions/runs/26813574484" } ] }