INSTALLING ami3

installation

There are two methods. If you are developing ami3 you should use the first. If you are doing production runs and not Maven-savvy then use the second JAR-file route

maven / IDE

If you can compile and run under maven and/or Eclipse/IntelliJ/Netbeans that's the most powerful way.

There are a lot of tests and a lot of them are out of date and fail, so we suggest

git clone https://github.com/petermr/ami3.git
cd ami3
mvn install -Dmaven.test.skip=true 

That will build ami3/target/appassembler/bin and ami3/target/appassembler/repo The exes are in the first. If your PATH contains this, then you can run ami commands. My path includes:

/Users/pm286/workspace/cmdev/ami3/target/appassembler/bin/

(Note that if you rebuild with maven or maven clean this dir gets wiped and overwritten by a new version.)

Single JAR method

Download the latest JAR from https://github.com/petermr/ami-jars3 NOTE CHANGED REPO. They are in dated directories, probably every few days. Use new ones if bugs are fixed or new features are added that you need.

General instructions.

see https://github.com/petermr/tigr2ess/blob/master/installation/INSTALLATION.md

This is a year old. It should be roughly accurate. PLEASE copy to openVirus and update if necessary

Apha Tester:

Name: Ambreen Hamadani

Installation

1. Downloaded and installed JDK from Oracle(https://www.oracle.com/java/technologies/javase-jdk14-downloads.html)
2. Downloaded and installed maven (https://maven.apache.org/install.html)
3. Cloned the ami3 from Github and added it to path as suggested above.
4. Tested its installation by running ami --help
5. Installation successful (0 errors, 0 warnings)

Usage

Reference Tutorial](https://github.com/petermr/openVirus/blob/master/examples/n95/OVERVIEW.md)

1. An attempt was made to run ami3 on 100 viral epidemic papers using country disease funders dictionaries.
2. getpapers was used to create directory and the respository of papers: getpapers -q "viral epidemics" -o ami_test_1 -f v_epid/log.txt -x -p -k 100
3. The directory, ami_test_1 was used as CProject directory for ami3: ami -p ami_test_1 search --dictionary country disease funders
4. 17 new files got created within ami_test_1 ( 12 XML, 1 folder, 4 HTML)
5. 0 Errors, multiple warnings like: Warning at procedure xsl:unnamed on line 0 XTDE0540 Ambiguous rule match for /article/front[1]/journal-meta[1]