=head1 DESCRIPTION
-Swap out one set of genes (or gene representation) for another in an
+Swap out one set of genes (or gene representations) for another in an
existing PathVisio GPML file. Optionally removes literature references.
If multiple replacement genes map to a single original gene,
=head1 USAGE
-pathway_gene_swapper.pl -i INPUT_FILE -g GENE_FILE -c CONFIG_FILE -o OUTPUT_FILE -v -G -d
+pathway_gene_swapper.pl -i INPUT_FILE -g GENE_FILE -c CONFIG_FILE -o OUTPUT_FILE -L -v -G -d
=head1 OPTIONS
# ---------------------------------------------------------------------------
=item B<hash config($file_path)>
+Accepts a config file path.
Reads a configuration file and sets config values.
Returns a hash with config values set.
=cut
}
# ---------------------------------------------------------------------------
-=item B<string create_unique_hex_id()>
+=item B<string create_unique_hex_id($hash_ref, $string_id_type)>
+Accepts a reference to a hash of existing hex ids and a string as
+the "type" of ID (e.g. "Group.GraphId"). The latter is currently for
+documentary purposes only.
Generates a "random" 5-digit hexadecimal id, checks to see if it
already exists in the hex list, and if not, adds it to the list
of hex ids already present in the GPML doc. Otherwise, generates