writer_indices and doc_indices arguments in get_clusters_batch() to be optional. The main reason for this change is so that users do not need to use a naming convention for their handwriting files in order to use handwriterRF::calculate_slr() and handwriterRF::compare_documents() which call get_clusters_batch().The new function plotGraphs() added in version 3.2.0 mistakenly was not exported. The function has been renamed as plot_graphs() and is now available to users.
Fixed a bug in get_clusters_batch() so it no longer returns the error message, "Unable to get cluster assignments for one or more documents," if the file all_clusters.rds exists in the output directory.
Fixed a bug in get_clusters_batch() so it no longer mistakenly returns the error message, "Unable to get cluster assignments for one or more documents," even if cluster assignments were successfully processed for all input documents.
If the graphs from the model training documents do not populate all available clusters in the cluster template, one or more of the graphs from the questioned document(s) could potentially be assigned to a cluster in the template that doesn't contain any model training graphs. Previously, analyze_questioned_documents() threw an error if this occurs. Now, it only throws an error if more than 10% of the graphs from the questioned documents are assigned to clusters that are not populated by model training graphs. The mismatch between clusters used by the model document graphs and clusters used by the questioned document(s) graphs only becomes an issue if it occurs for a large number of graphs.
The new function plot_cluster_centers() creates a plot of the clusters centers from a cluster template. The cluster centers are displayed as orange shapes. The function also plots all graphs in each cluster as grey shapes with 5% transparency to depict the variability of graph shapes within each cluster.
The new function plotGraphs() plots every graph in a document processed with processDocument().
Fixed bug in processDocument() when the writing in the document is a single connected component, such as a single word written in cursive. Previously, the output of processDocument() for this kind of document was formatted incorrectly.
Fixed bug in get_credible_intervals() and plot_credible_intervals() where the model writers were numbered sequentially. Now these functions use the writer IDs.
Fixed bug in format_template_data() where the function coerced writer IDs to integers even if the writer IDs contained characters.
Fixed bug in get_clusters_batch() where the function would stall but not return an error message if a document had a graph with a large number of edges (paths). Now the function ignores graphs with more than 30 edges.
Fixed bug in fit_model() where the function saves the same data in two separate files: "model_clusters.rds" and "all_clusters.rds". The argument 'save_master_file' was added to get_clusters_batch(). If TRUE, a data frame of all cluster assignments, "all_clusters.rds", will be saved. The default is FALSE.
fit_model() and analyze_questioned_documents() now allow writer IDs that contain numbers and letters.Increased the speed of processHandwriting() by changing the function to process a handwritten document in sections instead of all at once. Nodes created by processHandwriting() in version 3.1.0 might differ slightly in placement from previous versions.
Fixed bugs in fit_model() and analyze_questioned_documents() introduced by the changes to process_batch_list() in version 3.0.0.
Major reductions made to the memory required by process_batch_list() so it can now process paragraph length documents from the CSAFE Handwriting Database on machines with 8 GB of RAM.
process_batch_list() now skips to the next document if an error is returned while trying to process a document. A log file records the document name(s) and error message(s) of any problem documents. If the user reruns process_batch_list() they now have the option to either try a second time to process problem documents or skip them entirely.
New function get_clusters_batch() calculates cluster assignments of all files in a directory.
fit_model() allows the user to fit a statistical model to known handwriting samples collected from a closed-set of persons.
analyze_questioned_documents() in conjunction with a model created by fit_model() allows a user to calculate the posterior probability that each known writer in the model is the writer of the questioned document(s). analyze_questioned_documents() only works when the questioned document(s) had to have been written by one of the model writers. This function must NOT be used if someone other than one of the model writers could written the questioned document(s) as it could yield misleading results.
processDocument() is a new wrapper function that runs readPNGBinary(), thinImage(), and processHandwriting() so the user doesn't need to run these functions individually.
plotImage(), plotImageThinned(), and plotNodes now only need one input, a document processed with processDocument()
processHandwriting() no longer crashes when the input writing is a single letter or word
read_and_process() superseded in favor of processDocument()
extractGraphs() superseded in favor of process_batch_dir()