At some point the PGAP GFF file output will be standardized to match other GFF files produced at NCBI; this release is to handle the small change in PGAP output. This release has no other differences from version 4.0.22, so if you're not using the --pgap or --annotation_format pgap options there is no need to update.

With the --pgap or --annotation_format pgap options AMRFinderPlus previously relied on the older non-standard format for the Name= section of the attributes field of the GFF to identify the associated protein sequence. With this update the --pgap option will parse either version of the GFF output of PGAP.

This release includes:

• A bug fix for Issue [https://github.com//issues/164] where AMRFinderPlus crashed on the combination of GZipped input files and --nucleotide_output or --protein_output.
• StxTyper version 1.0.42 which has some fixes for incomplete operons.

This version of AMRFinderPlus updates to StxTyper 1.0.40 and makes use of the --threads option to StxTyper that is new to that version. In addition we made some improvements to the tests, both at GitHub and in the included install tests.

No changes to results other than stx_operon results from StxTyper, and those changes should be minor. See the StxTyper release notes for details.

This release incorporates changes to standardize and improve the reporting format for StxTyper results in AMRFinderPlus. StxTyper is only run when the -organism Escherichia and -plus options are used and a nucleotide file is used as input. See the StxTyper release 1.0.31 for the details of these fairly minor changes in output format. There are no biologically significant differences in results with this release.

NOTE: This is a new major revision of AMRFinderPlus that has a changed database format. You will need to run amrfinder -U to get database release 2024-10-22.1 or later to use this version. This AMRFinderPlus includes StxTyper version 1.0.27 for E. coli Stx operon typing.

Software and database format changes

• See https://github.com/evolarjun/amr/wiki/New-in-AMRFinderPlus/ for more details.
• StxTyper (https://github.com/ncbi/stxtyper) which accurately types full-length stx operons now included with AMRFinderPlus.
• Database filename changes to standardize filenames and make writing scripts easier (See https://github.com/ncbi/amr/wiki/New-in-AMRFinderPlus for more information).
• Column names in output have been changed to more closely other NCBI Pathogen Detection resources such as MicroBIGG-E.
• Point mutations can now be reported with symbols different from the standard format.
• The optional hierarchy_node field will now contain two node IDs for fusion proteins and stx operons separated by '::'.
• The ability to have different curated blast cutoffs at multiple levels of the hierarchy with the same reference protein has been added.
• The same protein can be used both as a reference gene to be reported and as the reference for point mutations.

AMRFinderPlus v3.12.8 includes a new database format version. Because this version is incompatible with AMRFinderPlus databases from previous versions, amrfinder -u must be run once the software update is installed to get the latest version of the database.

This update includes the changes:

• Reference proteins now have stop codons. Input proteins that are not terminated with a ‘’ character are assumed to have a ‘’ at the end.
• Extended proteins are no longer “EXACT” hits, so the protein names will be that of the parent node for alleles.
• If a protein is hit by blast and the Blast Rule is violated, the Blast Rule of the parent family is checked, etc.
• --annotation_format prodigal input format added

This means that Previously extended hits that were 100% identical to, but longer than proteins in the database were called with the method "EXACTP" and now they are called "BLASTP". Blast results will still indicate that 100% of the database reference was covered at 100% identity, and you should still see that the "Target length" is longer than the "Reference sequence length".

1. Extended hits to allele sequences that were previously called EXACTP already had the element symbol was one node up the hierarchy (i.e. the gene symbol, not the allele symbol) the "Sequence name" was that of the ALLELE reference, and thus inconsistent with the element symbol assigned. This has been changed. Again, this does not affect previous "Element symbol" calls.

2. In combined protein + nucleotide runs of AMRFinderPlus extended protein sequences with exact matches in the database were ignored and the nucleotide match was taken resulting in an EXACTX match with no protein accession provided. Now the protein match with method BLASTP will be reported.

To reiterate, gene symbols should not change. Sequence names will only change if the query is an extended version of a protein 100% identical and completely covering an allele in the database.

Fix for rare crash and change in behavior of hierarchy_node. This release will likely have no effect for most AMRFinderPlus users.

• Fixes an unusual crash when using the --ident_min option with very low identity cutoffs (we generally don't recommend using this option).
• A change in the behavior of the --print_node option. It will now print the node associated with the element reported, rather than the most specific node hit. This changes the node reported for non-exact blast hits to reference sequences of named alleles to report the parent node. It should have no effect on all other hits and does not affect the behavior of AMRFinderPlus in any field other than hierarchy_node.

This is a minor bug-fix release with two fixes:

• Fix for a protein sequence that could cause AMRFinderPlus to crash. This was very rare, we saw one failure in running on over a million assemblies and all RefSeq proteins.
• Found and fixed another case where AMRFinderPlus would produce two lines for what should really be a single partial hit reported.

AMRFinderPlus version 3.11.17 is another minor bug fix release

It fixes a bug where some point mutation results could be duplicated in AMRFinderPlus output. There will no longer be two rows in the AMRFinderPlus output for these circumstances.

This bug only affected a few point mutations that occur at/near the end of proteins where we had to add mutated reference sequences to a BLAST database to get BLAST to align through them. We have only seen this bug in our data for the following point mutations: ftsI_I336IKYRI, ftsI_N337NYRIN, mgrB_W47R, and ramR_A19V. See the point mutations in the Reference Gene Catalog for more information about those specific mutations.

This is a minor software release update with two changes. A bug fix for a very rare bug with mild consequences, and a minor improvement in the functionality of the --update option.

The release fixes a bug when AMRFinderPlus is run in combined nucleotide and protein mode where only a partial gene was assembled for proteins with long amino-acid repeats (e.g., espF, CAI43856.1). In the right circumstances AMRFinderPlus could report multiple combined hits to the same gene with the same start and stop coordinates. We've only seen the exact triggering circumstances a few times in more than a million assemblies, so it should be very rare. This release fixes that bug.

The release also contains a minor improvement to amrfinder_update to also create the parent database directory if it doesn't exist when amrfinder_update is run.