getting_started_with_pbj

Prerequisites:

• Latest cTAKES version installed
• Python installed
• Artemis installed

Artemis Instructions For making a Broker:

1. Download Apache ActiveMQ Artemis here: https://activemq.apache.org/components/artemis/download/
   
2. Navigate to the downloaded apache-artemis-version folder in your command line
   
3. Navigate into bin, then use these commands ./artemis create [name of your broker] for Mac and Linux or artemis create [name of your broker] for Windows (These commands will create a broker that is needed to run PBJ)

• You will be prompted to create a username and password, as well as --allow-anonymous, Press Y for this option
  

4. Now navigate into your brokers' bin folder
   Optional: cTakes should run your broker for you but if it does not work, run the command ./artemis run for Mac and Linux or artemis run for Windows to start the broker
   

For more information see apache-artemis documentation for further documentation.

Run Your First Example

1. Start by creating an application configuration in your IDE (I will be using Intellij for this example)
   
2. Create a name for it and copy down the information you see in the picture below
   

3. In this next step you will need to have made an artimis broker as well as have python installed, we also recommend creating a venv for this project which you can do by following this guide
4. In the program arguments section include these parameters
   -p "PbjSentencePrinter" (path to program you would like to run)
   -i "org/apache/ctakes/examples/notes/annotated" (path to input folder)
   -a "[Destination of your Artemis Broker]"
-v "[Destinaiton of your virtual env]"
-o "output folder"