[u/mrichter/AliRoot.git] / MUON / AliMUONGeometryMisAligner.cxx

/**************************************************************************
 * Copyright(c) 1998-1999, ALICE Experiment at CERN, All rights reserved. *
 *      SigmaEffect_thetadegrees                                          * 
 * Author: The ALICE Off-line Project.                                    *
 * Contributors are mentioned in the code where appropriate.              *
 *                                                                        *
 * Permission to use, copy, modify and distribute this software and its   *
 * documentation strictly for non-commercial purposes is hereby granted   *
 * without fee, provided that the above copyright notice appears in all   *
 * copies and that both the copyright notice and this permission notice   *
 * appear in the supporting documentation. The authors make no claims     *
 * about the suitability of this software for any purpeateose. It is      *
 * provided "as is" without express or implied warranty.                  *
 **************************************************************************/

// $Id$
//
//-----------------------------------------------------------------------------
/// \class AliMUONGeometryMisAligner
///
/// This performs the misalignment on an existing muon arm geometry
/// based on the standard definition of the detector elements in 
/// $ALICE_ROOT/MUON/data
///
/// --> User has to specify the magnitude of the alignments, in the Cartesian 
/// co-ordiantes (which are used to apply translation misalignments) and in the
/// spherical co-ordinates (which are used to apply angular displacements)
///
/// --> If the constructor is used with no arguments, user has to set 
/// misalignment ranges by hand using the methods : 
/// SetApplyMisAlig, SetMaxCartMisAlig, SetMaxAngMisAlig, SetXYAngMisAligFactor
/// (last method takes account of the fact that the misalingment is greatest in 
/// the XY plane, since the detection elements are fixed to a support structure
/// in this plane. Misalignments in the XZ and YZ plane will be very small 
/// compared to those in the XY plane, which are small already - of the order 
/// of microns)
///
/// Note : If the detection elements are allowed to be misaligned in all
/// directions, this has consequences for the alignment algorithm
/// (AliMUONAlignment), which needs to know the number of free parameters. 
/// Eric only allowed 3 :  x,y,theta_xy, but in principle z and the other 
/// two angles are alignable as well.
///
/// \author Bruce Becker, Javier Castillo
//-----------------------------------------------------------------------------

#include "AliMUONGeometryMisAligner.h"
#include "AliMUONGeometryTransformer.h"
#include "AliMUONGeometryModuleTransformer.h"
#include "AliMUONGeometryDetElement.h"
#include "AliMUONGeometryBuilder.h"

#include "AliMpExMap.h"

#include "AliLog.h"

#include <TGeoMatrix.h>
#include <TMath.h>
#include <TRandom.h>
#include <Riostream.h>

/// \cond CLASSIMP
ClassImp(AliMUONGeometryMisAligner)
/// \endcond

//______________________________________________________________________________
AliMUONGeometryMisAligner::AliMUONGeometryMisAligner(Double_t cartXMisAligM, Double_t cartXMisAligW, Double_t cartYMisAligM, Double_t cartYMisAligW, Double_t angMisAligM, Double_t angMisAligW)
  : TObject(),
    fUseUni(kFALSE),
    fUseGaus(kTRUE),
    fXYAngMisAligFactor(0.0),
    fZCartMisAligFactor(0.0),
    fDisplacementGenerator(0)
{
  /// Standard constructor
  for (Int_t i=0; i<6; i++){
    for (Int_t j=0; j<2; j++){
      fDetElemMisAlig[i][j] = 0.0;
      fModuleMisAlig[i][j] = 0.0;
    }
  }
  fDetElemMisAlig[0][0] = cartXMisAligM; 
  fDetElemMisAlig[0][1] = cartXMisAligW; 
  fDetElemMisAlig[1][0] = cartYMisAligM; 
  fDetElemMisAlig[1][1] = cartYMisAligW; 
  fDetElemMisAlig[5][0] = angMisAligM; 
  fDetElemMisAlig[5][1] = angMisAligW;

  fDisplacementGenerator = new TRandom(0);
}

//______________________________________________________________________________
AliMUONGeometryMisAligner::AliMUONGeometryMisAligner(Double_t cartMisAligM, Double_t cartMisAligW, Double_t angMisAligM, Double_t angMisAligW)
  : TObject(), 
    fUseUni(kFALSE),
    fUseGaus(kTRUE),
    fXYAngMisAligFactor(0.0),
    fZCartMisAligFactor(0.0),
    fDisplacementGenerator(0)
{
  /// Standard constructor
  for (Int_t i=0; i<6; i++){
    for (Int_t j=0; j<2; j++){
      fDetElemMisAlig[i][j] = 0.0;
      fModuleMisAlig[i][j] = 0.0;
    }
  }
  fDetElemMisAlig[0][0] = cartMisAligM; 
  fDetElemMisAlig[0][1] = cartMisAligW; 
  fDetElemMisAlig[1][0] = cartMisAligM; 
  fDetElemMisAlig[1][1] = cartMisAligW; 
  fDetElemMisAlig[5][0] = angMisAligM; 
  fDetElemMisAlig[5][1] = angMisAligW;

  fDisplacementGenerator = new TRandom(0);
}

//______________________________________________________________________________
AliMUONGeometryMisAligner::AliMUONGeometryMisAligner(Double_t cartMisAlig, Double_t angMisAlig)
  : TObject(), 
    fUseUni(kTRUE),
    fUseGaus(kFALSE),
    fXYAngMisAligFactor(0.0),
    fZCartMisAligFactor(0.0),
    fDisplacementGenerator(0)
{
  /// Standard constructor
  for (Int_t i=0; i<6; i++){
    for (Int_t j=0; j<2; j++){
      fDetElemMisAlig[i][j] = 0.0;
      fModuleMisAlig[i][j] = 0.0;
    }
  }
  fDetElemMisAlig[0][1] = cartMisAlig; 
  fDetElemMisAlig[1][1] = cartMisAlig; 
  fDetElemMisAlig[5][1] = angMisAlig;

  fDisplacementGenerator = new TRandom(0);
}

//_____________________________________________________________________________
AliMUONGeometryMisAligner::AliMUONGeometryMisAligner()
  : TObject(), 
    fUseUni(kTRUE),
    fUseGaus(kFALSE),
    fXYAngMisAligFactor(0.0),
    fZCartMisAligFactor(0.0),
    fDisplacementGenerator(0)
{
  /// Default constructor
  for (Int_t i=0; i<6; i++){
    for (Int_t j=0; j<2; j++){
      fDetElemMisAlig[i][j] = 0.0;
      fModuleMisAlig[i][j] = 0.0;
    }
  }
}

//______________________________________________________________________________
AliMUONGeometryMisAligner::~AliMUONGeometryMisAligner()
{
/// Destructor

  if (fDisplacementGenerator) delete fDisplacementGenerator;
}

//_________________________________________________________________________
void
AliMUONGeometryMisAligner::SetXYAngMisAligFactor(Double_t factor)
{
  /// Set XY angular misalign factor 

  if (TMath::Abs(factor) > 1.0 && factor > 0.){
    fXYAngMisAligFactor = factor;
    fDetElemMisAlig[3][0] = fDetElemMisAlig[5][0]*factor; // These lines were 
    fDetElemMisAlig[3][1] = fDetElemMisAlig[5][1]*factor; // added to keep
    fDetElemMisAlig[4][0] = fDetElemMisAlig[5][0]*factor; // backward 
    fDetElemMisAlig[4][1] = fDetElemMisAlig[5][1]*factor; // compatibility 
  }
  else
    AliError(Form("Invalid XY angular misalign factor, %d", factor));
}

//_________________________________________________________________________
void AliMUONGeometryMisAligner::SetZCartMisAligFactor(Double_t factor) 
{
  /// Set XY angular misalign factor 
  if (TMath::Abs(factor)<1.0 && factor>0.) {
    fZCartMisAligFactor = factor;
    fDetElemMisAlig[2][0] = fDetElemMisAlig[0][0];        // These lines were added to 
    fDetElemMisAlig[2][1] = fDetElemMisAlig[0][1]*factor; // keep backward compatibility
  }
  else
    AliError(Form("Invalid Z cartesian misalign factor, %d", factor));
}

//_________________________________________________________________________
void AliMUONGeometryMisAligner::GetUniMisAlign(Double_t cartMisAlig[3], Double_t angMisAlig[3], const Double_t lParMisAlig[6][2]) const
{
  /// Misalign using uniform distribution
  /**
    misalign the centre of the local transformation
    rotation axes : 
    fAngMisAlig[1,2,3] = [x,y,z]
    Assume that misalignment about the x and y axes (misalignment of z plane)
    is much smaller, since the entire detection plane has to be moved (the 
    detection elements are on a support structure), while rotation of the x-y
    plane is more free.
  */
  cartMisAlig[0] = fDisplacementGenerator->Uniform(-lParMisAlig[0][1]+lParMisAlig[0][0], lParMisAlig[0][0]+lParMisAlig[0][1]);
  cartMisAlig[1] = fDisplacementGenerator->Uniform(-lParMisAlig[1][1]+lParMisAlig[1][0], lParMisAlig[1][0]+lParMisAlig[1][1]);
  cartMisAlig[2] = fDisplacementGenerator->Uniform(-lParMisAlig[2][1]+lParMisAlig[2][0], lParMisAlig[2][0]+lParMisAlig[2][1]);  
 
  angMisAlig[0] = fDisplacementGenerator->Uniform(-lParMisAlig[3][1]+lParMisAlig[3][0], lParMisAlig[3][0]+lParMisAlig[3][1]);
  angMisAlig[1] = fDisplacementGenerator->Uniform(-lParMisAlig[4][1]+lParMisAlig[4][0], lParMisAlig[4][0]+lParMisAlig[4][1]);
  angMisAlig[2] = fDisplacementGenerator->Uniform(-lParMisAlig[5][1]+lParMisAlig[5][0], lParMisAlig[5][0]+lParMisAlig[5][1]);	// degrees
}

//_________________________________________________________________________
void AliMUONGeometryMisAligner::GetGausMisAlign(Double_t cartMisAlig[3], Double_t angMisAlig[3], const Double_t lParMisAlig[6][2]) const
{
  /// Misalign using gaussian distribution
  /**
    misalign the centre of the local transformation
    rotation axes : 
    fAngMisAlig[1,2,3] = [x,y,z]
    Assume that misalignment about the x and y axes (misalignment of z plane)
    is much smaller, since the entire detection plane has to be moved (the 
    detection elements are on a support structure), while rotation of the x-y
    plane is more free.
  */
  cartMisAlig[0] = fDisplacementGenerator->Gaus(lParMisAlig[0][0], lParMisAlig[0][1]);
  cartMisAlig[1] = fDisplacementGenerator->Gaus(lParMisAlig[1][0], lParMisAlig[1][1]);
  cartMisAlig[2] = fDisplacementGenerator->Gaus(lParMisAlig[2][0], lParMisAlig[2][1]);
 
  angMisAlig[0] = fDisplacementGenerator->Gaus(lParMisAlig[3][0], lParMisAlig[3][1]);
  angMisAlig[1] = fDisplacementGenerator->Gaus(lParMisAlig[4][0], lParMisAlig[4][1]);
  angMisAlig[2] = fDisplacementGenerator->Gaus(lParMisAlig[5][0], lParMisAlig[5][1]);	// degrees
}

//_________________________________________________________________________
TGeoCombiTrans AliMUONGeometryMisAligner::MisAlignDetElem(const TGeoCombiTrans & transform) const
{
  /// Misalign given transformation and return the misaligned transformation. 
  /// Use misalignment parameters for detection elements.
  /// Note that applied misalignments are small deltas with respect to the detection 
  /// element own ideal local reference frame. Thus deltaTransf represents 
  /// the transformation to go from the misaligned d.e. local coordinates to the 
  /// ideal d.e. local coordinates. 
  /// Also note that this -is not- what is in the ALICE alignment framework known 
  /// as local nor global (see AliMUONGeometryMisAligner::MisAlign) 
  
  Double_t cartMisAlig[3] = {0,0,0};
  Double_t angMisAlig[3] = {0,0,0};

  if (fUseUni) { 
    GetUniMisAlign(cartMisAlig,angMisAlig,fDetElemMisAlig);
  }
  else { 
    if (!fUseGaus) {
      AliWarning("Neither uniform nor gausian distribution is set! Will use gausian...");
    } 
    GetGausMisAlign(cartMisAlig,angMisAlig,fDetElemMisAlig);
  }

  TGeoTranslation deltaTrans(cartMisAlig[0], cartMisAlig[1], cartMisAlig[2]);
  TGeoRotation deltaRot;
  deltaRot.RotateX(angMisAlig[0]);
  deltaRot.RotateY(angMisAlig[1]);
  deltaRot.RotateZ(angMisAlig[2]);

  TGeoCombiTrans deltaTransf(deltaTrans,deltaRot);
  TGeoHMatrix newTransfMat = transform * deltaTransf;
    
  AliInfo(Form("Rotated DE by %f about Z axis.", angMisAlig[2]));

  return TGeoCombiTrans(newTransfMat);
}

//_________________________________________________________________________
TGeoCombiTrans AliMUONGeometryMisAligner::MisAlignModule(const TGeoCombiTrans & transform) const
{
  /// Misalign given transformation and return the misaligned transformation. 
  /// Use misalignment parameters for modules.
  /// Note that applied misalignments are small deltas with respect to the module 
  /// own ideal local reference frame. Thus deltaTransf represents 
  /// the transformation to go from the misaligned module local coordinates to the 
  /// ideal module local coordinates. 
  /// Also note that this -is not- what is in the ALICE alignment framework known 
  /// as local nor global (see AliMUONGeometryMisAligner::MisAlign) 
  
  Double_t cartMisAlig[3] = {0,0,0};
  Double_t angMisAlig[3] = {0,0,0};

  if (fUseUni) { 
    GetUniMisAlign(cartMisAlig,angMisAlig,fModuleMisAlig);
  }
  else { 
    if (!fUseGaus) {
      AliWarning("Neither uniform nor gausian distribution is set! Will use gausian...");
    } 
    GetGausMisAlign(cartMisAlig,angMisAlig,fModuleMisAlig);
  }

  TGeoTranslation deltaTrans(cartMisAlig[0], cartMisAlig[1], cartMisAlig[2]);
  TGeoRotation deltaRot;
  deltaRot.RotateX(angMisAlig[0]);
  deltaRot.RotateY(angMisAlig[1]);
  deltaRot.RotateZ(angMisAlig[2]);

  TGeoCombiTrans deltaTransf(deltaTrans,deltaRot);
  TGeoHMatrix newTransfMat = transform * deltaTransf;

  AliInfo(Form("Rotated Module by %f about Z axis.", angMisAlig[2]));

  return TGeoCombiTrans(newTransfMat);
}

//______________________________________________________________________
AliMUONGeometryTransformer *
AliMUONGeometryMisAligner::MisAlign(const AliMUONGeometryTransformer *
				    transformer, Bool_t verbose)
{
  /// Takes the internal geometry module transformers, copies them to
  /// new geometry module transformers. 
  /// Calculates  module misalignment parameters and applies these
  /// to the new module transformer.
  /// Calculates the module misalignment delta transformation in the 
  /// Alice Alignment Framework newTransf = delta * oldTransf.
  /// Add a module misalignment to the new geometry transformer.
  /// Gets the Detection Elements from the module transformer. 
  /// Calculates misalignment parameters and applies these
  /// to the local transformation of the Detection Element.
  /// Obtains the new global transformation by multiplying the new 
  /// module transformer transformation with the new local transformation. 
  /// Applies the new global transform to a new detection element.
  /// Adds the new detection element to a new module transformer.
  /// Calculates the d.e. misalignment delta transformation in the 
  /// Alice Alignment Framework (newGlobalTransf = delta * oldGlobalTransf).
  /// Add a d.e. misalignment to the new geometry transformer.
  /// Adds the new module transformer to a new geometry transformer.
  /// Returns the new geometry transformer.


  AliMUONGeometryTransformer *newGeometryTransformer =
    new AliMUONGeometryTransformer();
  for (Int_t iMt = 0; iMt < transformer->GetNofModuleTransformers(); iMt++)
    {				// module transformers
      const AliMUONGeometryModuleTransformer *kModuleTransformer =
	transformer->GetModuleTransformer(iMt, true);
      
      AliMUONGeometryModuleTransformer *newModuleTransformer =
	new AliMUONGeometryModuleTransformer(iMt);
      newGeometryTransformer->AddModuleTransformer(newModuleTransformer);

      TGeoCombiTrans moduleTransform =
	TGeoCombiTrans(*kModuleTransformer->GetTransformation());
      // New module transformation
      TGeoCombiTrans newModuleTransform = MisAlignModule(moduleTransform);
      newModuleTransformer->SetTransformation(newModuleTransform);

      // Get delta transformation: 
      // Tdelta = Tnew * Told.inverse
      TGeoHMatrix deltaModuleTransform = 
	AliMUONGeometryBuilder::Multiply(
	  newModuleTransform, 
	  kModuleTransformer->GetTransformation()->Inverse());

      // Create module mis alignment matrix
      newGeometryTransformer
	->AddMisAlignModule(kModuleTransformer->GetModuleId(), deltaModuleTransform);

      AliMpExMap *detElements = kModuleTransformer->GetDetElementStore();

      if (verbose)
	AliInfo(Form("%i DEs in old GeometryStore  %i",detElements->GetSize(), iMt));

      for (Int_t iDe = 0; iDe < detElements->GetSize(); iDe++)
	{			// detection elements.
	  AliMUONGeometryDetElement *detElement =
	    (AliMUONGeometryDetElement *) detElements->GetObject(iDe);

	  if (!detElement)
	    AliFatal("Detection element not found.");

	  /// make a new detection element
	  AliMUONGeometryDetElement *newDetElement =
	    new AliMUONGeometryDetElement(detElement->GetId(),
					  detElement->GetVolumePath());

	  // local transformation of this detection element.
          TGeoCombiTrans localTransform
	    = TGeoCombiTrans(*detElement->GetLocalTransformation());
	  TGeoCombiTrans newLocalTransform = MisAlignDetElem(localTransform);
          newDetElement->SetLocalTransformation(newLocalTransform);


	  // global transformation
	  TGeoHMatrix newGlobalTransform =
	    AliMUONGeometryBuilder::Multiply(newModuleTransform,
					     newLocalTransform);
	  newDetElement->SetGlobalTransformation(newGlobalTransform);
	  
	  // add this det element to module
	  newModuleTransformer->GetDetElementStore()->Add(newDetElement->GetId(),
							  newDetElement);

	  // In the Alice Alignment Framework misalignment objects store
	  // global delta transformation
	  // Get detection "intermediate" global transformation
	  TGeoHMatrix newOldGlobalTransform = newModuleTransform * localTransform;
          // Get detection element global delta transformation: 
	  // Tdelta = Tnew * Told.inverse
	  TGeoHMatrix  deltaGlobalTransform
	    = AliMUONGeometryBuilder::Multiply(
	        newGlobalTransform, 
		newOldGlobalTransform.Inverse());
	  
	  // Create mis alignment matrix
	  newGeometryTransformer
	    ->AddMisAlignDetElement(detElement->GetId(), deltaGlobalTransform);
	}

      
      if (verbose)
	AliInfo(Form("Added module transformer %i to the transformer", iMt));
      newGeometryTransformer->AddModuleTransformer(newModuleTransformer);
    }
  return newGeometryTransformer;
}
Commit	Line	Data
21dd83fc	1	/**************************************************************************
	2	* Copyright(c) 1998-1999, ALICE Experiment at CERN, All rights reserved. *
	3	* SigmaEffect_thetadegrees *
	4	* Author: The ALICE Off-line Project. *
	5	* Contributors are mentioned in the code where appropriate. *
	6	* *
	7	* Permission to use, copy, modify and distribute this software and its *
	8	* documentation strictly for non-commercial purposes is hereby granted *
	9	* without fee, provided that the above copyright notice appears in all *
	10	* copies and that both the copyright notice and this permission notice *
	11	* appear in the supporting documentation. The authors make no claims *
	12	* about the suitability of this software for any purpeateose. It is *
	13	* provided "as is" without express or implied warranty. *
	14	**************************************************************************/
	15
	16	// $Id$
	17	//
3d1463c8	18	//-----------------------------------------------------------------------------
a9aad96e	19	/// \class AliMUONGeometryMisAligner
	20	///
	21	/// This performs the misalignment on an existing muon arm geometry
	22	/// based on the standard definition of the detector elements in
	23	/// $ALICE_ROOT/MUON/data
	24	///
	25	/// --> User has to specify the magnitude of the alignments, in the Cartesian
	26	/// co-ordiantes (which are used to apply translation misalignments) and in the
	27	/// spherical co-ordinates (which are used to apply angular displacements)
	28	///
	29	/// --> If the constructor is used with no arguments, user has to set
	30	/// misalignment ranges by hand using the methods :
	31	/// SetApplyMisAlig, SetMaxCartMisAlig, SetMaxAngMisAlig, SetXYAngMisAligFactor
	32	/// (last method takes account of the fact that the misalingment is greatest in
	33	/// the XY plane, since the detection elements are fixed to a support structure
	34	/// in this plane. Misalignments in the XZ and YZ plane will be very small
	35	/// compared to those in the XY plane, which are small already - of the order
	36	/// of microns)
	37	///
	38	/// Note : If the detection elements are allowed to be misaligned in all
	39	/// directions, this has consequences for the alignment algorithm
	40	/// (AliMUONAlignment), which needs to know the number of free parameters.
	41	/// Eric only allowed 3 : x,y,theta_xy, but in principle z and the other
	42	/// two angles are alignable as well.
	43	///
4600314b	44	/// \author Bruce Becker, Javier Castillo
3d1463c8	45	//-----------------------------------------------------------------------------
21dd83fc	46
21dd83fc	47	#include "AliMUONGeometryMisAligner.h"
	48	#include "AliMUONGeometryTransformer.h"
	49	#include "AliMUONGeometryModuleTransformer.h"
	50	#include "AliMUONGeometryDetElement.h"
21dd83fc	51	#include "AliMUONGeometryBuilder.h"
ef79ed3a	52
8c95578a	53	#include "AliMpExMap.h"
8c95578a	54
ef79ed3a	55	#include "AliLog.h"
ef79ed3a	56
328e160e	57	#include <TGeoMatrix.h>
21dd83fc	58	#include <TMath.h>
21dd83fc	59	#include <TRandom.h>
ef4cb4f1	60	#include <Riostream.h>
21dd83fc	61
a9aad96e	62	/// \cond CLASSIMP
21dd83fc	63	ClassImp(AliMUONGeometryMisAligner)
a9aad96e	64	/// \endcond
a9aad96e	65
328e160e	66	//______________________________________________________________________________
328e160e	67	AliMUONGeometryMisAligner::AliMUONGeometryMisAligner(Double_t cartXMisAligM, Double_t cartXMisAligW, Double_t cartYMisAligM, Double_t cartYMisAligW, Double_t angMisAligM, Double_t angMisAligW)
8395bff1	68	: TObject(),
	69	fUseUni(kFALSE),
	70	fUseGaus(kTRUE),
8395bff1	71	fXYAngMisAligFactor(0.0),
	72	fZCartMisAligFactor(0.0),
	73	fDisplacementGenerator(0)
328e160e	74	{
328e160e	75	/// Standard constructor
4600314b	76	for (Int_t i=0; i<6; i++){
	77	for (Int_t j=0; j<2; j++){
	78	fDetElemMisAlig[i][j] = 0.0;
	79	fModuleMisAlig[i][j] = 0.0;
	80	}
	81	}
	82	fDetElemMisAlig[0][0] = cartXMisAligM;
	83	fDetElemMisAlig[0][1] = cartXMisAligW;
	84	fDetElemMisAlig[1][0] = cartYMisAligM;
	85	fDetElemMisAlig[1][1] = cartYMisAligW;
	86	fDetElemMisAlig[5][0] = angMisAligM;
	87	fDetElemMisAlig[5][1] = angMisAligW;
	88
328e160e	89	fDisplacementGenerator = new TRandom(0);
328e160e	90	}
	91
	92	//______________________________________________________________________________
	93	AliMUONGeometryMisAligner::AliMUONGeometryMisAligner(Double_t cartMisAligM, Double_t cartMisAligW, Double_t angMisAligM, Double_t angMisAligW)
8395bff1	94	: TObject(),
	95	fUseUni(kFALSE),
	96	fUseGaus(kTRUE),
8395bff1	97	fXYAngMisAligFactor(0.0),
	98	fZCartMisAligFactor(0.0),
	99	fDisplacementGenerator(0)
328e160e	100	{
328e160e	101	/// Standard constructor
4600314b	102	for (Int_t i=0; i<6; i++){
	103	for (Int_t j=0; j<2; j++){
	104	fDetElemMisAlig[i][j] = 0.0;
	105	fModuleMisAlig[i][j] = 0.0;
	106	}
	107	}
	108	fDetElemMisAlig[0][0] = cartMisAligM;
	109	fDetElemMisAlig[0][1] = cartMisAligW;
	110	fDetElemMisAlig[1][0] = cartMisAligM;
	111	fDetElemMisAlig[1][1] = cartMisAligW;
	112	fDetElemMisAlig[5][0] = angMisAligM;
	113	fDetElemMisAlig[5][1] = angMisAligW;
	114
328e160e	115	fDisplacementGenerator = new TRandom(0);
328e160e	116	}
328e160e	117
21dd83fc	118	//______________________________________________________________________________
21dd83fc	119	AliMUONGeometryMisAligner::AliMUONGeometryMisAligner(Double_t cartMisAlig, Double_t angMisAlig)
8395bff1	120	: TObject(),
	121	fUseUni(kTRUE),
	122	fUseGaus(kFALSE),
8395bff1	123	fXYAngMisAligFactor(0.0),
	124	fZCartMisAligFactor(0.0),
	125	fDisplacementGenerator(0)
21dd83fc	126	{
21dd83fc	127	/// Standard constructor
4600314b	128	for (Int_t i=0; i<6; i++){
	129	for (Int_t j=0; j<2; j++){
	130	fDetElemMisAlig[i][j] = 0.0;
	131	fModuleMisAlig[i][j] = 0.0;
	132	}
	133	}
	134	fDetElemMisAlig[0][1] = cartMisAlig;
	135	fDetElemMisAlig[1][1] = cartMisAlig;
	136	fDetElemMisAlig[5][1] = angMisAlig;
	137
21dd83fc	138	fDisplacementGenerator = new TRandom(0);
	139	}
	140
	141	//_____________________________________________________________________________
	142	AliMUONGeometryMisAligner::AliMUONGeometryMisAligner()
8395bff1	143	: TObject(),
	144	fUseUni(kTRUE),
	145	fUseGaus(kFALSE),
8395bff1	146	fXYAngMisAligFactor(0.0),
	147	fZCartMisAligFactor(0.0),
	148	fDisplacementGenerator(0)
21dd83fc	149	{
8395bff1	150	/// Default constructor
4600314b	151	for (Int_t i=0; i<6; i++){
	152	for (Int_t j=0; j<2; j++){
	153	fDetElemMisAlig[i][j] = 0.0;
	154	fModuleMisAlig[i][j] = 0.0;
	155	}
	156	}
21dd83fc	157	}
21dd83fc	158
21dd83fc	159	//______________________________________________________________________________
	160	AliMUONGeometryMisAligner::~AliMUONGeometryMisAligner()
	161	{
	162	/// Destructor
	163
8395bff1	164	if (fDisplacementGenerator) delete fDisplacementGenerator;
21dd83fc	165	}
21dd83fc	166
490da820	167	//_________________________________________________________________________
21dd83fc	168	void
	169	AliMUONGeometryMisAligner::SetXYAngMisAligFactor(Double_t factor)
	170	{
328e160e	171	/// Set XY angular misalign factor
490da820	172
4600314b	173	if (TMath::Abs(factor) > 1.0 && factor > 0.){
21dd83fc	174	fXYAngMisAligFactor = factor;
4600314b	175	fDetElemMisAlig[3][0] = fDetElemMisAlig[5][0]*factor; // These lines were
	176	fDetElemMisAlig[3][1] = fDetElemMisAlig[5][1]*factor; // added to keep
	177	fDetElemMisAlig[4][0] = fDetElemMisAlig[5][0]*factor; // backward
	178	fDetElemMisAlig[4][1] = fDetElemMisAlig[5][1]*factor; // compatibility
	179	}
21dd83fc	180	else
328e160e	181	AliError(Form("Invalid XY angular misalign factor, %d", factor));
	182	}
	183
	184	//_________________________________________________________________________
	185	void AliMUONGeometryMisAligner::SetZCartMisAligFactor(Double_t factor)
	186	{
	187	/// Set XY angular misalign factor
4600314b	188	if (TMath::Abs(factor)<1.0 && factor>0.) {
328e160e	189	fZCartMisAligFactor = factor;
4600314b	190	fDetElemMisAlig[2][0] = fDetElemMisAlig[0][0]; // These lines were added to
	191	fDetElemMisAlig[2][1] = fDetElemMisAlig[0][1]*factor; // keep backward compatibility
	192	}
328e160e	193	else
	194	AliError(Form("Invalid Z cartesian misalign factor, %d", factor));
	195	}
	196
	197	//_________________________________________________________________________
4600314b	198	void AliMUONGeometryMisAligner::GetUniMisAlign(Double_t cartMisAlig[3], Double_t angMisAlig[3], const Double_t lParMisAlig[6][2]) const
328e160e	199	{
328e160e	200	/// Misalign using uniform distribution
a9aad96e	201	/**
328e160e	202	misalign the centre of the local transformation
	203	rotation axes :
	204	fAngMisAlig[1,2,3] = [x,y,z]
	205	Assume that misalignment about the x and y axes (misalignment of z plane)
	206	is much smaller, since the entire detection plane has to be moved (the
	207	detection elements are on a support structure), while rotation of the x-y
	208	plane is more free.
	209	*/
4600314b	210	cartMisAlig[0] = fDisplacementGenerator->Uniform(-lParMisAlig[0][1]+lParMisAlig[0][0], lParMisAlig[0][0]+lParMisAlig[0][1]);
	211	cartMisAlig[1] = fDisplacementGenerator->Uniform(-lParMisAlig[1][1]+lParMisAlig[1][0], lParMisAlig[1][0]+lParMisAlig[1][1]);
	212	cartMisAlig[2] = fDisplacementGenerator->Uniform(-lParMisAlig[2][1]+lParMisAlig[2][0], lParMisAlig[2][0]+lParMisAlig[2][1]);
328e160e	213
4600314b	214	angMisAlig[0] = fDisplacementGenerator->Uniform(-lParMisAlig[3][1]+lParMisAlig[3][0], lParMisAlig[3][0]+lParMisAlig[3][1]);
	215	angMisAlig[1] = fDisplacementGenerator->Uniform(-lParMisAlig[4][1]+lParMisAlig[4][0], lParMisAlig[4][0]+lParMisAlig[4][1]);
	216	angMisAlig[2] = fDisplacementGenerator->Uniform(-lParMisAlig[5][1]+lParMisAlig[5][0], lParMisAlig[5][0]+lParMisAlig[5][1]); // degrees
328e160e	217	}
	218
	219	//_________________________________________________________________________
4600314b	220	void AliMUONGeometryMisAligner::GetGausMisAlign(Double_t cartMisAlig[3], Double_t angMisAlig[3], const Double_t lParMisAlig[6][2]) const
328e160e	221	{
328e160e	222	/// Misalign using gaussian distribution
a9aad96e	223	/**
328e160e	224	misalign the centre of the local transformation
	225	rotation axes :
	226	fAngMisAlig[1,2,3] = [x,y,z]
	227	Assume that misalignment about the x and y axes (misalignment of z plane)
	228	is much smaller, since the entire detection plane has to be moved (the
	229	detection elements are on a support structure), while rotation of the x-y
	230	plane is more free.
	231	*/
4600314b	232	cartMisAlig[0] = fDisplacementGenerator->Gaus(lParMisAlig[0][0], lParMisAlig[0][1]);
	233	cartMisAlig[1] = fDisplacementGenerator->Gaus(lParMisAlig[1][0], lParMisAlig[1][1]);
	234	cartMisAlig[2] = fDisplacementGenerator->Gaus(lParMisAlig[2][0], lParMisAlig[2][1]);
328e160e	235
4600314b	236	angMisAlig[0] = fDisplacementGenerator->Gaus(lParMisAlig[3][0], lParMisAlig[3][1]);
	237	angMisAlig[1] = fDisplacementGenerator->Gaus(lParMisAlig[4][0], lParMisAlig[4][1]);
	238	angMisAlig[2] = fDisplacementGenerator->Gaus(lParMisAlig[5][0], lParMisAlig[5][1]); // degrees
21dd83fc	239	}
	240
	241	//_________________________________________________________________________
4600314b	242	TGeoCombiTrans AliMUONGeometryMisAligner::MisAlignDetElem(const TGeoCombiTrans & transform) const
21dd83fc	243	{
4600314b	244	/// Misalign given transformation and return the misaligned transformation.
	245	/// Use misalignment parameters for detection elements.
	246	/// Note that applied misalignments are small deltas with respect to the detection
	247	/// element own ideal local reference frame. Thus deltaTransf represents
	248	/// the transformation to go from the misaligned d.e. local coordinates to the
	249	/// ideal d.e. local coordinates.
	250	/// Also note that this -is not- what is in the ALICE alignment framework known
	251	/// as local nor global (see AliMUONGeometryMisAligner::MisAlign)
21dd83fc	252
	253	Double_t cartMisAlig[3] = {0,0,0};
	254	Double_t angMisAlig[3] = {0,0,0};
328e160e	255
328e160e	256	if (fUseUni) {
4600314b	257	GetUniMisAlign(cartMisAlig,angMisAlig,fDetElemMisAlig);
328e160e	258	}
	259	else {
	260	if (!fUseGaus) {
	261	AliWarning("Neither uniform nor gausian distribution is set! Will use gausian...");
	262	}
4600314b	263	GetGausMisAlign(cartMisAlig,angMisAlig,fDetElemMisAlig);
328e160e	264	}
328e160e	265
4600314b	266	TGeoTranslation deltaTrans(cartMisAlig[0], cartMisAlig[1], cartMisAlig[2]);
	267	TGeoRotation deltaRot;
	268	deltaRot.RotateX(angMisAlig[0]);
	269	deltaRot.RotateY(angMisAlig[1]);
	270	deltaRot.RotateZ(angMisAlig[2]);
	271
	272	TGeoCombiTrans deltaTransf(deltaTrans,deltaRot);
	273	TGeoHMatrix newTransfMat = transform * deltaTransf;
	274
ef4cb4f1	275	AliInfo(Form("Rotated DE by %f about Z axis.", angMisAlig[2]));
4600314b	276
	277	return TGeoCombiTrans(newTransfMat);
	278	}
	279
	280	//_________________________________________________________________________
	281	TGeoCombiTrans AliMUONGeometryMisAligner::MisAlignModule(const TGeoCombiTrans & transform) const
	282	{
	283	/// Misalign given transformation and return the misaligned transformation.
	284	/// Use misalignment parameters for modules.
	285	/// Note that applied misalignments are small deltas with respect to the module
	286	/// own ideal local reference frame. Thus deltaTransf represents
	287	/// the transformation to go from the misaligned module local coordinates to the
	288	/// ideal module local coordinates.
	289	/// Also note that this -is not- what is in the ALICE alignment framework known
	290	/// as local nor global (see AliMUONGeometryMisAligner::MisAlign)
21dd83fc	291
4600314b	292	Double_t cartMisAlig[3] = {0,0,0};
	293	Double_t angMisAlig[3] = {0,0,0};
	294
	295	if (fUseUni) {
	296	GetUniMisAlign(cartMisAlig,angMisAlig,fModuleMisAlig);
	297	}
	298	else {
	299	if (!fUseGaus) {
	300	AliWarning("Neither uniform nor gausian distribution is set! Will use gausian...");
	301	}
	302	GetGausMisAlign(cartMisAlig,angMisAlig,fModuleMisAlig);
	303	}
	304
	305	TGeoTranslation deltaTrans(cartMisAlig[0], cartMisAlig[1], cartMisAlig[2]);
	306	TGeoRotation deltaRot;
	307	deltaRot.RotateX(angMisAlig[0]);
	308	deltaRot.RotateY(angMisAlig[1]);
	309	deltaRot.RotateZ(angMisAlig[2]);
21dd83fc	310
4600314b	311	TGeoCombiTrans deltaTransf(deltaTrans,deltaRot);
	312	TGeoHMatrix newTransfMat = transform * deltaTransf;
	313
	314	AliInfo(Form("Rotated Module by %f about Z axis.", angMisAlig[2]));
	315
	316	return TGeoCombiTrans(newTransfMat);
21dd83fc	317	}
21dd83fc	318
21dd83fc	319	//______________________________________________________________________
	320	AliMUONGeometryTransformer *
	321	AliMUONGeometryMisAligner::MisAlign(const AliMUONGeometryTransformer *
4600314b	322	transformer, Bool_t verbose)
21dd83fc	323	{
4600314b	324	/// Takes the internal geometry module transformers, copies them to
	325	/// new geometry module transformers.
	326	/// Calculates module misalignment parameters and applies these
	327	/// to the new module transformer.
	328	/// Calculates the module misalignment delta transformation in the
	329	/// Alice Alignment Framework newTransf = delta * oldTransf.
	330	/// Add a module misalignment to the new geometry transformer.
	331	/// Gets the Detection Elements from the module transformer.
a9aad96e	332	/// Calculates misalignment parameters and applies these
4600314b	333	/// to the local transformation of the Detection Element.
	334	/// Obtains the new global transformation by multiplying the new
	335	/// module transformer transformation with the new local transformation.
	336	/// Applies the new global transform to a new detection element.
	337	/// Adds the new detection element to a new module transformer.
	338	/// Calculates the d.e. misalignment delta transformation in the
	339	/// Alice Alignment Framework (newGlobalTransf = delta * oldGlobalTransf).
	340	/// Add a d.e. misalignment to the new geometry transformer.
	341	/// Adds the new module transformer to a new geometry transformer.
	342	/// Returns the new geometry transformer.
21dd83fc	343
	344
	345	AliMUONGeometryTransformer *newGeometryTransformer =
ef4cb4f1	346	new AliMUONGeometryTransformer();
21dd83fc	347	for (Int_t iMt = 0; iMt < transformer->GetNofModuleTransformers(); iMt++)
21dd83fc	348	{ // module transformers
21dd83fc	349	const AliMUONGeometryModuleTransformer *kModuleTransformer =
	350	transformer->GetModuleTransformer(iMt, true);
	351
	352	AliMUONGeometryModuleTransformer *newModuleTransformer =
	353	new AliMUONGeometryModuleTransformer(iMt);
	354	newGeometryTransformer->AddModuleTransformer(newModuleTransformer);
	355
ef79ed3a	356	TGeoCombiTrans moduleTransform =
ef79ed3a	357	TGeoCombiTrans(*kModuleTransformer->GetTransformation());
4600314b	358	// New module transformation
	359	TGeoCombiTrans newModuleTransform = MisAlignModule(moduleTransform);
	360	newModuleTransformer->SetTransformation(newModuleTransform);
	361
	362	// Get delta transformation:
	363	// Tdelta = Tnew * Told.inverse
	364	TGeoHMatrix deltaModuleTransform =
	365	AliMUONGeometryBuilder::Multiply(
	366	newModuleTransform,
	367	kModuleTransformer->GetTransformation()->Inverse());
	368
	369	// Create module mis alignment matrix
	370	newGeometryTransformer
	371	->AddMisAlignModule(kModuleTransformer->GetModuleId(), deltaModuleTransform);
21dd83fc	372
8c95578a	373	AliMpExMap *detElements = kModuleTransformer->GetDetElementStore();
21dd83fc	374
21dd83fc	375	if (verbose)
4600314b	376	AliInfo(Form("%i DEs in old GeometryStore %i",detElements->GetSize(), iMt));
21dd83fc	377
8c95578a	378	for (Int_t iDe = 0; iDe < detElements->GetSize(); iDe++)
21dd83fc	379	{ // detection elements.
21dd83fc	380	AliMUONGeometryDetElement *detElement =
8c95578a	381	(AliMUONGeometryDetElement *) detElements->GetObject(iDe);
4600314b	382
21dd83fc	383	if (!detElement)
	384	AliFatal("Detection element not found.");
	385
ef79ed3a	386	/// make a new detection element
21dd83fc	387	AliMUONGeometryDetElement *newDetElement =
21dd83fc	388	new AliMUONGeometryDetElement(detElement->GetId(),
ef79ed3a	389	detElement->GetVolumePath());
21dd83fc	390
ef79ed3a	391	// local transformation of this detection element.
	392	TGeoCombiTrans localTransform
	393	= TGeoCombiTrans(*detElement->GetLocalTransformation());
4600314b	394	TGeoCombiTrans newLocalTransform = MisAlignDetElem(localTransform);
	395	newDetElement->SetLocalTransformation(newLocalTransform);
	396
21dd83fc	397
ef79ed3a	398	// global transformation
ef79ed3a	399	TGeoHMatrix newGlobalTransform =
4600314b	400	AliMUONGeometryBuilder::Multiply(newModuleTransform,
4600314b	401	newLocalTransform);
21dd83fc	402	newDetElement->SetGlobalTransformation(newGlobalTransform);
ef79ed3a	403
	404	// add this det element to module
	405	newModuleTransformer->GetDetElementStore()->Add(newDetElement->GetId(),
21dd83fc	406	newDetElement);
4600314b	407
	408	// In the Alice Alignment Framework misalignment objects store
	409	// global delta transformation
	410	// Get detection "intermediate" global transformation
	411	TGeoHMatrix newOldGlobalTransform = newModuleTransform * localTransform;
	412	// Get detection element global delta transformation:
ef79ed3a	413	// Tdelta = Tnew * Told.inverse
4600314b	414	TGeoHMatrix deltaGlobalTransform
ef79ed3a	415	= AliMUONGeometryBuilder::Multiply(
ef79ed3a	416	newGlobalTransform,
4600314b	417	newOldGlobalTransform.Inverse());
ef79ed3a	418
	419	// Create mis alignment matrix
	420	newGeometryTransformer
4600314b	421	->AddMisAlignDetElement(detElement->GetId(), deltaGlobalTransform);
21dd83fc	422	}
4600314b	423
4600314b	424
21dd83fc	425	if (verbose)
	426	AliInfo(Form("Added module transformer %i to the transformer", iMt));
	427	newGeometryTransformer->AddModuleTransformer(newModuleTransformer);
	428	}
	429	return newGeometryTransformer;
	430	}
	431
	432
	433
	434