{ "_id": "6a3268a73efcd9bda4386677", "Package": "nicheR", "Type": "Package", "Title": "Ellipsoid-Based Virtual Niches and Visualization", "Version": "0.1.0", "Authors@R": "c(\nperson(\n\"Mariana\", \"Castaneda-Guzman\",\nemail = \"marianacg@vt.edu\",\nrole = c(\"aut\", \"cre\"),\ncomment = c(ORCID = \"0000-0001-6106-4284\")\n),\nperson(\n\"Connor\", \"Hughes\",\nemail = \"connorjh@vt.edu\",\nrole = \"aut\",\ncomment = c(ORCID = \"0000-0002-3720-0837\")\n),\nperson(\n\"Paanwaris\", \"Paansri\",\nemail = \"paanwaris@vt.edu\",\nrole = \"aut\",\ncomment = c(ORCID = \"0000-0001-9992-098X\")\n),\nperson(\n\"Marlon E.\", \"Cobos\",\nemail = \"manubio13@gmail.com\",\nrole = \"aut\",\ncomment = c(ORCID = \"0000-0002-2611-1767\")\n)\n)", "Description": "Provides a robust set of tools for researchers and\nmodelers to construct and define virtual ecological niches\nusing ellipsoid geometries. It enables the identification and\nextraction of suitable environmental areas, simulation of\nspecies occurrence points with various sampling strategies, and\nvisualization of niche boundaries and simulated occurrences in\nboth environmental and geographic space. Inspired by\nmethodologies in 'NicheA' and the 'virtualspecies' R package,\n'nicheR' aims to streamline the process of niche\nconceptualization and data generation for ecological studies.\nMethodological and theoretical foundations are described in\nPeterson et al. (2011, ISBN:9780691136882), Etherington et al.\n(2009) , Qiao et al.\n(2015) , Nunez-Penichet et al. (2021)\n, Cobos and Peterson (2022)\n, Alkishe et al. (2022)\n, and Leroy et al. (2015)\n.", "URL": "https://github.com/castanedaM/nicheR,\nhttps://castanedam.github.io/nicheR/", "BugReports": "https://github.com/castanedaM/nicheR/issues", "VignetteBuilder": "knitr", "License": "MIT + file LICENSE", "Encoding": "UTF-8", "LazyData": "true", "Config/roxygen2/version": "8.0.0", "Config/pak/sysreqs": "libgdal-dev gdal-bin libgeos-dev libproj-dev\nlibsqlite3-dev", "Repository": "https://castanedam.r-universe.dev", "Date/Publication": "2026-06-08 16:02:48 UTC", "RemoteUrl": "https://github.com/castanedam/nicher", "RemoteRef": "HEAD", "RemoteSha": "5bc29818a0d71e3e2b13177c73d88271876232a9", "NeedsCompilation": "no", "Packaged": { "Date": "2026-06-17 09:23:53 UTC", "User": "root" }, "Author": "Mariana Castaneda-Guzman [aut, cre] (ORCID:\n),\nConnor Hughes [aut] (ORCID: ),\nPaanwaris Paansri [aut] (ORCID:\n),\nMarlon E. Cobos [aut] (ORCID: )", "Maintainer": "Mariana Castaneda-Guzman ", "MD5sum": "54d9fb6464ea64ff83b77c6b82c43337", "_user": "castanedam", "_type": "src", "_file": "nicheR_0.1.0.tar.gz", "_fileid": "4c017851e4b74fbc7b02b75c27a3b18322c817bdb450e694750a1377ad5f7f3f", "_filesize": 11260651, "_sha256": "4c017851e4b74fbc7b02b75c27a3b18322c817bdb450e694750a1377ad5f7f3f", "_created": "2026-06-17T09:23:53.000Z", "_published": "2026-06-17T09:28:07.985Z", "_distro": "noble", "_jobs": [ { "job": 81861662513, "time": 189, "config": "linux-devel-x86_64", "r": "4.7.0", "check": "OK", "artifact": "7691278558" }, { "job": 81861662516, "time": 188, "config": "linux-release-x86_64", "r": "4.6.0", "check": "OK", "artifact": "7691276135" }, { "job": 81861662521, "time": 194, "config": "macos-oldrel-arm64", "r": "4.5.3", "check": "OK", "artifact": "7691265025" }, { "job": 81861662446, "time": 180, "config": "macos-release-arm64", "r": "4.6.0", "check": "OK", "artifact": "7691260719" }, { "job": 81860915892, "time": 230, "config": "source", "r": "4.6.0", "check": "OK", "artifact": "7691201964" }, { "job": 81861662409, "time": 114, "config": "wasm-release", "r": "4.6.0", "check": "OK", "artifact": "7691247304" }, { "job": 81861662502, "time": 182, "config": "windows-devel", "r": "4.7.0", "check": "OK", "artifact": "7691272129" }, { "job": 81861662478, "time": 152, "config": "windows-oldrel", "r": "4.5.3", "check": "OK", "artifact": "7691261480" }, { "job": 81861662472, "time": 143, "config": "windows-release", "r": "4.6.0", "check": "OK", "artifact": "7691258267" } ], "_buildurl": "https://github.com/r-universe/castanedam/actions/runs/27678841338", "_status": "success", "_host": "GitHub-Actions", "_upstream": "https://github.com/castanedam/nicher", "_commit": { "id": "5bc29818a0d71e3e2b13177c73d88271876232a9", "author": "Mariana Castaneda-Guzman ", "committer": "Mariana Castaneda-Guzman ", "message": "new cran submission\n", "time": 1780934568 }, "_maintainer": { "name": "Mariana Castaneda-Guzman", "email": "marianacg@vt.edu", "orcid": "0000-0001-6106-4284" }, "_registered": true, "_dependencies": [ { "package": "R", "version": ">= 3.5", "role": "Depends" }, { "package": "terra", "role": "Imports" }, { "package": "rgl", "version": ">= 1.3", "role": "Suggests" }, { "package": "knitr", "role": "Suggests" }, { "package": "rmarkdown", "role": "Suggests" } ], "_owner": "castanedam", "_selfowned": true, "_usedby": 0, "_updates": [ { "week": "2025-34", "n": 11 }, { "week": "2025-35", "n": 8 }, { "week": "2025-37", "n": 8 }, { "week": "2025-39", "n": 1 }, { "week": "2025-41", "n": 3 }, { "week": "2025-42", "n": 16 }, { "week": "2025-43", "n": 3 }, { "week": "2025-45", "n": 1 }, { "week": "2025-46", "n": 8 }, { "week": "2025-47", "n": 35 }, { "week": "2026-03", "n": 6 }, { "week": "2026-04", "n": 3 }, { "week": "2026-05", "n": 14 }, { "week": "2026-07", "n": 19 }, { "week": "2026-08", "n": 2 }, { "week": "2026-09", "n": 5 }, { "week": "2026-10", "n": 27 }, { "week": "2026-11", "n": 9 }, { "week": "2026-13", "n": 14 }, { "week": "2026-14", "n": 2 }, { "week": "2026-15", "n": 5 }, { "week": "2026-17", "n": 68 }, { "week": "2026-18", "n": 21 }, { "week": "2026-19", "n": 12 }, { "week": "2026-21", "n": 11 }, { "week": "2026-22", "n": 4 }, { "week": "2026-23", "n": 3 }, { "week": "2026-24", "n": 3 } ], "_tags": [], "_topics": [ "ecology-modeling", "niche-modeling", "simulation", "virtual-species", "visualization" ], "_stars": 2, "_contributors": [ { "user": "castanedam", "count": 193, "uuid": 22383501 }, { "user": "paanwaris", "count": 150, "uuid": 81313703 }, { "user": "marlonecobos", "count": 60, "uuid": 19596631 }, { "user": "cjhughes926", "count": 9, "uuid": 60192092 } ], "_userbio": { "uuid": 22383501, "type": "user", "name": "Mariana Castaneda-Guzman", "followers": 3, "description": "PhD student developing methods to evaluate ecological data and improve niche modeling approaches." }, "_downloads": { "count": 0, "source": "https://cranlogs.r-pkg.org/downloads/total/last-month/nicheR" }, "_devurl": "https://github.com/castanedam/nicher", "_pkgdown": "https://castanedam.github.io/nicheR/", "_searchresults": 13, "_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/nicheR.html", "extra/readme.html", "extra/readme.md", "LICENSE", "manual.pdf" ], "_homeurl": "https://github.com/castanedam/nicher", "_realowner": "castanedam", "_cranurl": true, "_releases": [ { "version": "0.1.0", "date": "2026-06-16" } ], "_exports": [ "add_data", "add_data_3d", "add_ellipsoid", "add_ellipsoid_3d", "apply_bias", "build_ellipsoid", "conserved_ellipses", "covariance_limits", "ellipsoid_calculator", "ellipsoid_volume", "nested_ellipses", "new_nicheR_community", "plot_community", "plot_ellipsoid", "plot_ellipsoid_3d", "plot_ellipsoid_pairs", "prepare_bias", "random_ellipses", "ranges_from_data", "ranges_from_stats", "read_nicheR", "sample_biased_data", "sample_data", "save_nicheR", "update_covariance", "update_ellipsoid_covariance", "virtual_data" ], "_datasets": [ { "name": "back_data", "title": "Background environmental data for examples", "object": "back_data", "class": [ "data.frame" ], "fields": [ "x", "y", "bio_1", "bio_5", "bio_6", "bio_7", "bio_12", "bio_13", "bio_14", "bio_15" ], "rows": 10047, "table": true, "tojson": true }, { "name": "example_sp_1", "title": "Example niche ellipsoid objects for virtual communities", "object": "example_sp_1", "class": [ "nicheR_ellipsoid" ], "fields": [], "table": false, "tojson": false }, { "name": "example_sp_2", "title": "Example niche ellipsoid objects for virtual communities", "object": "example_sp_2", "class": [ "nicheR_ellipsoid" ], "fields": [], "table": false, "tojson": false }, { "name": "example_sp_3", "title": "Example niche ellipsoid objects for virtual communities", "object": "example_sp_3", "class": [ "nicheR_ellipsoid" ], "fields": [], "table": false, "tojson": false }, { "name": "example_sp_4", "title": "Example niche ellipsoid objects for virtual communities", "object": "example_sp_4", "class": [ "nicheR_ellipsoid" ], "fields": [], "table": false, "tojson": false }, { "name": "ref_ellipse", "title": "Reference ellipse for virtual community examples", "object": "ref_ellipse", "class": [ "nicheR_ellipsoid" ], "fields": [], "table": false, "tojson": false } ], "_help": [ { "page": "add_data", "title": "Add occurrence points or other data to an existing E-space plot", "topics": [ "add_data" ] }, { "page": "add_data_3d", "title": "Add data to an existing 3D E-space plot", "topics": [ "add_data_3d" ] }, { "page": "add_ellipsoid", "title": "Add an ellipsoid boundary to an existing E-space plot", "topics": [ "add_ellipsoid" ] }, { "page": "add_ellipsoid_3d", "title": "Add an ellipsoid to an existing 3D E-space plot", "topics": [ "add_ellipsoid_3d" ] }, { "page": "apply_bias", "title": "Apply sampling bias to suitability surfaces", "topics": [ "apply_bias" ] }, { "page": "back_data", "title": "Background environmental data for examples", "topics": [ "back_data" ] }, { "page": "build_ellipsoid", "title": "Build a probabilistic ellipsoidal niche from ranges", "topics": [ "build_ellipsoid" ] }, { "page": "conserved_ellipses", "title": "Generate ellipses via multivariate normal biased sampling", "topics": [ "conserved_ellipses" ] }, { "page": "covariance_limits", "title": "Calculate safe covariance ranges for positive definiteness", "topics": [ "covariance_limits" ] }, { "page": "ellipsoid_calculator", "title": "Calculate n-dimensional ellipsoid metrics", "topics": [ "ellipsoid_calculator" ] }, { "page": "ellipsoid_volume", "title": "Compute ellipsoid hypervolume", "topics": [ "ellipsoid_volume" ] }, { "page": "example_ellipsoids", "title": "Example niche ellipsoid objects for virtual communities", "topics": [ "example_ellipsoids", "example_sp_1", "example_sp_2", "example_sp_3", "example_sp_4" ] }, { "page": "ma_bios", "title": "Bioclimatic variables for part of the Americas", "topics": [ "ma_bios" ] }, { "page": "nested_ellipses", "title": "Generate nested ellipses based on a reference ellipse", "topics": [ "nested_ellipses" ] }, { "page": "plot_community", "title": "Plot a nicheR Community of Ellipses", "topics": [ "plot_community" ] }, { "page": "plot_ellipsoid", "title": "Plot a nicheR ellipsoid in environmental space", "topics": [ "plot_ellipsoid" ] }, { "page": "plot_ellipsoid_3d", "title": "Plot a nicheR ellipsoid in 3D environmental space", "topics": [ "plot_ellipsoid_3d" ] }, { "page": "plot_ellipsoid_pairs", "title": "Plot all pairwise 2D ellipsoid projections", "topics": [ "plot_ellipsoid_pairs" ] }, { "page": "predict", "title": "Predict suitability and Mahalanobis distance from a nicheR ellipsoid", "topics": [ "predict", "predict,nicheR_nicheR_community-method", "predict,nicheR_nicheR_ellipsoid-method", "predict.nicheR_community", "predict.nicheR_ellipsoid" ] }, { "page": "prepare_bias", "title": "Prepare sampling bias surfaces", "topics": [ "prepare_bias" ] }, { "page": "print", "title": "Print method for nicheR objects", "topics": [ "print", "print,nicheR_nicheR_community-method", "print,nicheR_nicheR_ellipsoid-method", "print.nicheR_community", "print.nicheR_ellipsoid" ] }, { "page": "random_ellipses", "title": "Generate random ellipses constrained by a point cloud and a reference ellipse", "topics": [ "random_ellipses" ] }, { "page": "range_utilities", "title": "Compute variable ranges from data or statistics with optional expansion", "topics": [ "ranges_from_data", "ranges_from_stats", "range_utilities" ] }, { "page": "read_nicheR", "title": "Read a nicheR object from disk", "topics": [ "read_nicheR" ] }, { "page": "ref_ellipse", "title": "Reference ellipse for virtual community examples", "topics": [ "ref_ellipse" ] }, { "page": "sample_biased_data", "title": "Sample occurrence data from a bias-weighted prediction surface", "topics": [ "sample_biased_data" ] }, { "page": "sample_data", "title": "Sample occurrence data from a prediction surface", "topics": [ "sample_data" ] }, { "page": "save_nicheR", "title": "Save a nicheR object to disk", "topics": [ "save_nicheR" ] }, { "page": "update_covariance", "title": "Update covariance values and calculate remaining safe limits", "topics": [ "update_covariance" ] }, { "page": "update_ellipsoid_covariance", "title": "Update covariances in a nicheR ellipsoid and recompute metrics", "topics": [ "update_ellipsoid_covariance" ] }, { "page": "virtual_data", "title": "Generate data based on a ellipsoidal niche", "topics": [ "virtual_data" ] } ], "_readme": "https://github.com/castanedam/nicher/raw/HEAD/README.md", "_rundeps": [ "Rcpp", "terra" ], "_vignettes": [ { "source": "bias.Rmd", "filename": "bias.html", "title": "Bias surface", "engine": "knitr::rmarkdown", "headings": [ "Summary", "Description", "Getting ready", "Preparing the Bias Layer", "Function Arguments", "Example: Mixed-Direction Composite Bias", "Applying Bias to Predictions", "Function Arguments", "Example: Comparing Applied Biases", "Three-Dimensional Example", "Save and export" ], "created": "2026-04-03 13:38:49", "modified": "2026-05-29 17:19:58", "commits": 6 }, { "source": "creating_ellipsoid_based_niches.Rmd", "filename": "creating_ellipsoid_based_niches.html", "title": "Creating Ellipsoid Based Niches", "engine": "knitr::rmarkdown", "headings": [ "Summary", "Description", "Getting ready", "Loading example data", "Building and visualizing ellipsoid niches", "Background", "Creating a basic ellipsoid", "Adjusting ellipsoid covariance", "Comparing multiple species niches", "Save and import", "Working in more than 2 dimensions" ], "created": "2026-04-03 13:38:52", "modified": "2026-05-29 17:19:58", "commits": 7 }, { "source": "generating_occurrence.Rmd", "filename": "generating_occurrence.html", "title": "Generate occurrence data", "engine": "knitr::rmarkdown", "headings": [ "Summary", "Description", "Getting ready", "Part 1: Virtual Data", "Basic generation", "Visualizing virtual data in 2D", "Three-dimensional virtual example", "Part 2: Spatially-Explicit Occurrence Data", "Basic generation in 2D", "Effect of the sampling argument", "Effect of the method argument", "Effect of the strict argument", "Three-Dimensional Example", "Part 3: Biased Occurrence Data", "Basic biased generation in 2D", "Effect of the biased strict argument", "Three-Dimensional Biased Example", "Save and export" ], "created": "2026-04-27 14:47:28", "modified": "2026-05-29 17:19:58", "commits": 8 }, { "source": "predict.Rmd", "filename": "predict.html", "title": "Predicting suitability and Mahalanobis distance", "engine": "knitr::rmarkdown", "headings": [ "Summary", "Description", "Getting ready", "Loading example data", "Using predict()", "Basic predictions to a data frame", "Basic predictions to a SpatRaster", "Understanding the output", "Mahalanobis distance and the ellipsoid", "From distance to suitability: the chi-square and MVN connection", "Additional function arguments", "All four outputs at once", "The role of the confidence level and truncation", "Effect of the confidence level on predictions", "Visualizing predictions in environmental space", "Mahalanobis distance in E-space", "Suitability in E-space", "Truncated predictions in E-space", "Binary suitable vs. unsuitable environments", "Visualizing predictions in geographic space", "Mahalanobis distance map", "Suitability map", "Truncated suitability map", "Binary potential distribution map", "Three-dimensional example", "Predicting with virtual data", "Two-dimensional virtual data", "Three-dimensional virtual data", "Save and import" ], "created": "2026-04-03 13:38:52", "modified": "2026-05-22 15:41:35", "commits": 6 }, { "source": "virtual_communities.Rmd", "filename": "virtual_communities.html", "title": "Virtual community simulation", "engine": "knitr::rmarkdown", "headings": [ "Summary", "Description", "Getting ready", "Loading example data", "Simulating random communities", "Effect of background density", "Effect of proportion arguments", "Simulating nested communities", "Effect of proportion argument", "Effect of bias argument", "Simulating niche conservatism in communities", "Predictions for communities", "Predict to data frames", "Predict to SpatRaster", "Truncating predictions", "Simple community outcomes", "Save and import" ], "created": "2026-03-06 02:11:51", "modified": "2026-05-22 15:41:35", "commits": 10 }, { "source": "plotting_vignette.Rmd", "filename": "plotting_vignette.html", "title": "Visualizing ellipsoids in environmental space", "engine": "knitr::rmarkdown", "headings": [ "Summary", "Description", "Getting ready", "Loading example data", "plot_ellipsoid()", "Ellipsoid boundary only", "Background points", "Prediction colored by a continuous variable", "Truncated predictions and grey outside region", "Reversed palette and transparency", "Subsampling large datasets", "Fixed axis limits for comparing ellipsoids", "add_data() and add_ellipsoid()", "Layering background, occurrences, and boundary", "Coloring occurrence points by a continuous variable", "plot_ellipsoid_pairs()", "Pairs with background", "Pairs with predictions" ], "created": "2026-04-03 13:38:52", "modified": "2026-04-03 13:38:52", "commits": 1 } ], "_score": 6.816373888752362, "_indexed": true, "_nocasepkg": "nicher", "_universes": [ "castanedam" ], "_binaries": [ { "r": "4.7.0", "os": "linux", "version": "0.1.0", "date": "2026-06-17T09:26:20.000Z", "distro": "noble", "commit": "5bc29818a0d71e3e2b13177c73d88271876232a9", "fileid": "87967448d848c7bebdaad4fdb464d7c51d0c6eac05a500eea6b3a4e064a71ae4", "status": "success", "check": "OK", "buildurl": "https://github.com/r-universe/castanedam/actions/runs/27678841338" }, { "r": "4.6.0", "os": "linux", "version": "0.1.0", "date": "2026-06-17T09:26:16.000Z", "distro": "noble", "commit": "5bc29818a0d71e3e2b13177c73d88271876232a9", "fileid": "65533dd2f525cacb08ec9c4e67a733d2e7e42bdfac5c9491dd914b008f5c959f", "status": "success", "check": "OK", "buildurl": "https://github.com/r-universe/castanedam/actions/runs/27678841338" }, { "r": "4.5.3", "os": "mac", "version": "0.1.0", "date": "2026-06-17T09:26:16.000Z", "commit": "5bc29818a0d71e3e2b13177c73d88271876232a9", "fileid": "9f7af48b87eda2aaa550cde5cae9b9605e9a5798722e59506b7530965b069ecd", "status": "success", "check": "OK", "buildurl": "https://github.com/r-universe/castanedam/actions/runs/27678841338" }, { "r": "4.6.0", "os": "mac", "version": "0.1.0", "date": "2026-06-17T09:26:05.000Z", "commit": "5bc29818a0d71e3e2b13177c73d88271876232a9", "fileid": "76f97243f335fab261f36c31f63011e281c698c32c8e354a1355abb262342452", "status": "success", "check": "OK", "buildurl": "https://github.com/r-universe/castanedam/actions/runs/27678841338" }, { "r": "4.6.0", "os": "wasm", "version": "0.1.0", "date": "2026-06-17T09:26:16.000Z", "commit": "5bc29818a0d71e3e2b13177c73d88271876232a9", "fileid": "69e9c34085b8af701dfc6c2b718a83d30b2d2884fadbd50a4e40d8b63053c810", "status": "success", "buildurl": "https://github.com/r-universe/castanedam/actions/runs/27678841338" }, { "r": "4.7.0", "os": "win", "version": "0.1.0", "date": "2026-06-17T09:25:51.000Z", "commit": "5bc29818a0d71e3e2b13177c73d88271876232a9", "fileid": "d8c5f080bb53a1864ad8aee45de9f2478668749bf3c088964b32866d0155cd77", "status": "success", "check": "OK", "buildurl": "https://github.com/r-universe/castanedam/actions/runs/27678841338" }, { "r": "4.5.3", "os": "win", "version": "0.1.0", "date": "2026-06-17T09:25:25.000Z", "commit": "5bc29818a0d71e3e2b13177c73d88271876232a9", "fileid": "79b1cbef82480b9ca3447066fc166b94a00f373bb1884c81241b0fb9a5d0e4d2", "status": "success", "check": "OK", "buildurl": "https://github.com/r-universe/castanedam/actions/runs/27678841338" }, { "r": "4.6.0", "os": "win", "version": "0.1.0", "date": "2026-06-17T09:25:35.000Z", "commit": "5bc29818a0d71e3e2b13177c73d88271876232a9", "fileid": "93a97a78144ab922c847cd65dd4ee23696b59171b484a6bdda80f16a274a5b73", "status": "success", "check": "OK", "buildurl": "https://github.com/r-universe/castanedam/actions/runs/27678841338" } ] }