NEWS.md
##2024-12-19 * remove validate_data_package() as this function was listed as “still under construction” is mostly obsolete given other functions and functions in the DPchecker package. * remove load_domains() as this function was not working properly and was conceived of before the data package specifications were properly set. ## 2024-12-19 * updated load_pkg_metadata to be simpler and essentially call DPchecker::load_metadata but with a preset default directory structure that works well with the default settings for get_data_package. * Add meta-analysis functions for finding and producing summary statistics multiple data packages including get_ref_list, get_refs_info(), and summarize_packages. ## 2024-10-24 * fix how get_data_package aliases get_data_packages, specifically now allows users to adjust parameters to non-default settings. ## 2024-10-21 * Bug fixes to load_data_package() * Bug fixes to .get_authors() * get_authors now adds a period (.) after given names with a single character and can handle an unlimited number of given names. * Moved sf, leaflet, and stringr to from imports to suggests. * Enable .get_contacts() to handle cases when there is only one contact.
load_data_packages() and load_data_package(), which can load data packages (EML in .xml and data in .csv) similarly to the deprecated load_data_package_deprecated() function but also allows the data types in the tibbles loaded to be specified based on the information in the metadata.load_data_package() and rename it to load_data_package_deprecated().get_data_packages() to take advantage of new helper functions.get_data_package() which aliases get_data_packages() mostly because many people will want to load one data package and forget that the function is plural.load_EML_df() to load_core_metadata()..get_authors() and .get_contacts() to retrieve authors and contacts (and emails) from EMLload_EML_df(), which retrieves commonly available metadata items from an EML-formatted R object and returns them as a single dataframe (for loading into Power BI)get_data_packages(): it will now check to see if a DataStore reference ID is invalid or not. It will also check whether the reference is a data package or not. Substantial feedback is reported to the user if the flag force is set to FALSE.rm_local_packages() which can delete one or more (or all) packages within a folder called “data” (where your packages should be if you downloaded them with get_data_packages()). This only deletes local copies and does not delete any data from DataStore.load_metadata() is now load_pkg_metadata() so as not to conflict with DPchecker::load_metadata()
get_data_packages() to (when force = FALSE) check for newer versions of requested data packages and prompt the user to download the newest version if they so choose.get_data_packages() to:get_data_packages() now inspects the location the data packages are being written to. If a folder with the data package reference id already exists, the function will prompt the user asking if they want to re-download and overwrite the existing data package (when force = FALSE)get_data_packages() now returns the full path to the data package folders, including the “/data” directory they are all in.get_park_taxon_refs() to hit v5/rest servicesget_park_taxon_refs() is the IRMA taxon code, not the ITIS TSN.get_park_taxon_refs() and get_park_taxon_citations() are hitting secure servers and warn users that the results may also need to be restricted.map_wkt() function to map points, polygons, or both from Well Known Text coordinates (WKT). WKT is used in place to GPS coordinates when sensitive species locations have been “fuzzed”. In this case, providing a polygon rather than the an exact (albeit fuzzed) is preferable as it is clear that the location is not exact. WKT is an efficient way to store geographic shapes such as polygons in flat files such as .csv.