MDQ_FADCPacketLoss
[Low Level Data Quality Checks]

Plots information related to loss of FADC packets over the network. More...

Functions
INT	MDQ_FADCPacketLoss_init (void)
INT	MDQ_FADCPacketLoss_BOR (INT run_number)
INT	MDQ_FADCPacketLoss_EOR (INT run_number)
INT	MDQ_FADCPacketLoss (EVENT_HEADER *, void *)
Variables
HNDLE	hDB
TGlobalData *	gData
	Object to hold data used and produced by modules throughout alcapana stage of analysis.
TSetupData *	gSetup
	Hardware information about digitizers and detectors to be used during alcapana stage of analysis.
static TH1 *	hDQ_FADCPacketLoss_Total
	Plots the total number of MIDAS events that had a packet loss per board.
static TH1 *	hDQ_FADCPacketLoss_Fraction
	Plots the fraction of MIDAS events that had a packet loss per board.
static TH2 *	hDQ_FADCPacketLoss_TotalByEvent
static int	n_total_midas_events
ANA_MODULE	MDQ_FADCPacketLoss_module

---

Detailed Description

Plots information related to loss of FADC packets over the network.

Author:

Andrew Edmonds

Joe Grange

Creates hDQ_FADCPacketLoss_Total, hDQ_FADCPacketLoss_Fraction, and hDQ_FADCPacketLoss_TotalByEvent.

---

Function Documentation

INT MDQ_FADCPacketLoss	(	EVENT_HEADER *	pheader,
		void *	pevent
	)

This method processes one MIDAS block, producing a vector of TOctalFADCIsland objects from the raw Octal FADC data.

Definition at line 150 of file MDQ_FADCPacketLoss.cpp.

References hDQ_FADCPacketLoss_Fraction, hDQ_FADCPacketLoss_Total, hDQ_FADCPacketLoss_TotalByEvent, and n_total_midas_events.

{
  // Get the event number
  int midas_event_number = pheader->serial_number;

  // Get the NLSS bank and get a pointer to the raw data
  unsigned int* raw; // points at the raw data
  int bankSize = bk_locate(pevent,"NLSS",&raw);

  int board_number = 0;
  int packet_lost = 0;
  int n_packets_lost = 0;

  bool Boards[256]; // We can have maximally 256 FADC boards due to the address space
  for(int i=0; i<256; ++i) Boards[i] = false;

  for (int i = 0; i < bankSize; i+=2) {
    board_number = *(raw+i);

    //printf(" event number %d i %d bank size %d board number %d\n",midas_event_number,i,bankSize,board_number);

    packet_lost = *(raw+i+1);
    
    if(*(raw+i) >= 0 && *(raw+i) < 255) Boards[i] = true;

    n_packets_lost++;
        //printf("Event #%d: Board %d lost packet #%d n packets lost %d\n", midas_event_number, board_number, packet_lost,n_packets_lost);

    // Fill Diagnostic histogram
    hDQ_FADCPacketLoss_Total->Fill(board_number, 1);   
    hDQ_FADCPacketLoss_Fraction->Fill(board_number, 1);
    hDQ_FADCPacketLoss_TotalByEvent->Fill(board_number,midas_event_number, 1);

  }

  ++n_total_midas_events;

  return SUCCESS;
}

INT MDQ_FADCPacketLoss_BOR

(

INT

run_number

)

This method executes at the start of each run

Definition at line 140 of file MDQ_FADCPacketLoss.cpp.

References n_total_midas_events.

{
  n_total_midas_events = 1;
  
  return SUCCESS;
}

INT MDQ_FADCPacketLoss_EOR

(

INT

run_number

)

Definition at line 190 of file MDQ_FADCPacketLoss.cpp.

References hDQ_FADCPacketLoss_Fraction, and n_total_midas_events.

{

  hDQ_FADCPacketLoss_Fraction->Scale(1.0 / n_total_midas_events);

  return SUCCESS;
}

INT MDQ_FADCPacketLoss_init

(

)

This method initializes histograms.

Definition at line 90 of file MDQ_FADCPacketLoss.cpp.

References hDB, hDQ_FADCPacketLoss_Fraction, hDQ_FADCPacketLoss_Total, and hDQ_FADCPacketLoss_TotalByEvent.

{
  // See if the DataQuality_LowLevel/ directory already exists
  if (!gDirectory->Cd("DataQuality_LowLevel")) {
    
    std::string dir_name("DataQuality_LowLevel/");
    gDirectory->mkdir(dir_name.c_str());
    gDirectory->Cd(dir_name.c_str());
  }

  // Get run number
  char key_name[80];
  int size,run_number;
  sprintf(key_name, "Runinfo/Run number");
  size=sizeof(int);
  db_get_value(hDB,0,key_name, &run_number, &size, TID_INT,1);

  // Create the histograms
  hDQ_FADCPacketLoss_Total = new TH1F(
    "hDQ_FADCPacketLoss_Total",
    Form("Total number of MIDAS Events with FADC packet loss per board, run %d",run_number),
    4,128, 132);
  hDQ_FADCPacketLoss_Total->SetBit(TH1::kCanRebin);
  hDQ_FADCPacketLoss_Total->GetXaxis()->SetTitle("FADC Board Number");
  hDQ_FADCPacketLoss_Total->GetYaxis()->SetTitle("Number of Events with lost packets");

  hDQ_FADCPacketLoss_Fraction = new TH1F(
    "hDQ_FADCPacketLoss_Fraction",
    Form("Fraction of MIDAS Events with FADC packet loss per board, run %d",run_number),
    4,128, 132);
  hDQ_FADCPacketLoss_Fraction->SetBit(TH1::kCanRebin);
  hDQ_FADCPacketLoss_Fraction->GetXaxis()->SetTitle("FADC Board Number");
  hDQ_FADCPacketLoss_Fraction->GetYaxis()->SetTitle("Fraction of Events with lost packets");

  hDQ_FADCPacketLoss_TotalByEvent = new TH2F(
    "hDQ_FADCPacketLoss_TotalByEvent",
    Form("FADC packet losses by board and event, run %d",run_number),
    4,128, 132,5000,0,5000);
  hDQ_FADCPacketLoss_TotalByEvent->SetBit(TH2::kCanRebin);
  hDQ_FADCPacketLoss_TotalByEvent->GetXaxis()->SetTitle("FADC Board Number");
  hDQ_FADCPacketLoss_TotalByEvent->GetYaxis()->SetTitle("MIDAS event");

  gDirectory->Cd("/MidasHists/");

  return SUCCESS;
}

---

Variable Documentation

TGlobalData* gData

Object to hold data used and produced by modules throughout alcapana stage of analysis.

Definition at line 76 of file analyzer.cpp.

TSetupData* gSetup

Hardware information about digitizers and detectors to be used during alcapana stage of analysis.

Definition at line 80 of file analyzer.cpp.

HNDLE hDB

hDQ_FADCPacketLoss_Fraction [static]

Plots the fraction of MIDAS events that had a packet loss per board.

Plots the total number of packet losses per board on an event-by-event basis.

Definition at line 69 of file MDQ_FADCPacketLoss.cpp.

Referenced by MDQ_FADCPacketLoss(), MDQ_FADCPacketLoss_EOR(), and MDQ_FADCPacketLoss_init().

hDQ_FADCPacketLoss_Total [static]

Plots the total number of MIDAS events that had a packet loss per board.

Definition at line 68 of file MDQ_FADCPacketLoss.cpp.

Referenced by MDQ_FADCPacketLoss(), and MDQ_FADCPacketLoss_init().

TH2* hDQ_FADCPacketLoss_TotalByEvent [static]

Definition at line 70 of file MDQ_FADCPacketLoss.cpp.

Referenced by MDQ_FADCPacketLoss(), and MDQ_FADCPacketLoss_init().

ANA_MODULE MDQ_FADCPacketLoss_module

Initial value:

{
  "MDQ_FADCPacketLoss",        
  "Andrew Edmonds",              
  MDQ_FADCPacketLoss,          
  MDQ_FADCPacketLoss_BOR,      
  MDQ_FADCPacketLoss_EOR,      
  MDQ_FADCPacketLoss_init,     
  NULL,                          
  NULL,                          
  0,                             
  NULL,                          
}

Definition at line 74 of file MDQ_FADCPacketLoss.cpp.

int n_total_midas_events [static]

Definition at line 71 of file MDQ_FADCPacketLoss.cpp.

Referenced by MDQ_FADCPacketLoss(), MDQ_FADCPacketLoss_BOR(), and MDQ_FADCPacketLoss_EOR().