This TRD-AMORE module has one „agent” and a “user interface”:

- The agent decodes the raw data by using the AliTRDrawStream class
   and fill the monitor objects (e.g. Histograms).
- The user interface visualizes the monitoring histograms.   

In the following you find a short documentation how to use amore and how to develop
the code:

AMORE for users:

   1. While logged in on aldaqacr35 (or aldaqacr36) login with ssh to aldaqdqm05 (pw TRD.233)
   2. go to the amore directory and set the environemt variables with the command:
      . amore_setup.sh
   2. Start the agent with the command 
      amoreAgent -a amoreAgentTRD03
      - You can select the DAQ datasource with -the option -s (DATE role : @gdc-aldaqpcXXX:, hostname or date file) switch.
      - You can also select the duration of one MonitorCycles in seconds (-t sec) or events (-e events).
      - Finally, you can specify that you want the agent to run continuously and to receive the SOR and EOR from ECS by setting the -u flag. 
  3. The list of configured agents can be viewed by running `dumpAmoreDbs`
  4. On a different console, start the GUI part by typing amore -d TRD -m TestModule
  5. Once the module is loaded, click on the button on bottom left labeled "Init".
  6. By clicking "Start" you start the updating loop of your histograms. The period in seconds can be defined by enetering the number in the
     box labeled "Update period" and pressing "Enter" key.
  7. By clicking "Update" you get an immediate update of all the histograms.
  8. By clicking "Stop" the screen update stops but the agents continue analyzing data. 

AMORE for users:
Here a short discripton about how to add a histogram and how to fill it is 
shown. More information about code development can be found at:
http://ph-dep-aid.web.cern.ch/ph-dep-aid/amore/
(please don't create an amoreAgent by yousrself. Ask daq people if you need an additional
one.)

Let's assume that you are logged in to aldaqdqm05 you are already in the directory amore and have set the environment variables like descriped above.
In the directory amore you will find also a directory which is called amore and where the source code kit for the TRD Module is
placed. This amore directory contains a subdirectory src which itself contains the subdirectories:
- publisher
- subscriber
- common
- ui
These directories contain code where you can add, fill and show histograms. After developping the code in a sibdirectory you can
type make install in the directry and the code will be compiled and the libraries will be copied to the directory  
amore/amore_site/lib. (you can also type make install from the directory /src if you want compile all subdirectories. Amore itself is 
already installed on aldaqdqm05 by daq people and isn't touched by TRD code developpers.

Let's now come to the special case that you want to add a histogram to the Agent which is filled and will be 
shown with the interface:
In the following the necessary changes in the subdirectories are shown:

(One Remark: It might be necessary to apply additional changes in the code.
 Below you will find a basic introduction and the available code in the svn 
 should help you in addition to apply all necessary changes!!!)  


common:
You have to add the histogram to TestModuleCommon.cxx:

           MonitorObjectH1F *mo_histo;                     
       
publisher: 
TestModul.cxx:
In the functionder BookMonitorObjects() the Monitor Object is published: 

         Publish(mo_histo,“MonitorObject_Histogramm“,“An example Histo“);

An in the function MonitorEvent() the histos are filled with the variable you want.

        mo_histo->Fill(variable);

Variables from the AliTRDrawStream are accessable!

ui:
In TestModule.cxx you have to make changes in the method SlotSelectedTab()

    
        Subscribe(MonitorObject_Histogramm);

and in the method update you have to add:

amore::core::MOH1F* histo=gSubscriber->At<amore::core::MOH1F>(MonitorObject_Histogramm);


The subdirectory subscriber stays untouched for the moment!