SubarrayControl.idl

Go to the documentation of this file.

#ifndef CARMA_CONTROL_SUBARRAYCONTROL_IDL
#define CARMA_CONTROL_SUBARRAYCONTROL_IDL

#include "carma/antenna/common/CalibratorControl.idl"
#include "carma/antenna/common/IVCurve.idl"
#include "carma/antenna/common/PolarizationControl.idl"
#include "carma/antenna/common/RxControl.idl"
#include "carma/antenna/common/SwitchState.idl"
#include "carma/control/CorrelatorInfo.idl"
#include "carma/control/Drives.idl"
#include "carma/control/OpticalTelescope.idl"
#include "carma/control/PadOffsets.idl"
#include "carma/control/NearestInfo.idl"
#include "carma/control/SequenceTypedefs.idl"
#include "carma/control/SignalPath.idl"
#include "carma/fault/FaultControl.idl"
#include "carma/monitor/monitorframe.idl"
#include "carma/observertools/ItemValue.idl"
#include "carma/observertools/ProjectDatabaseManager.idl"
#include "carma/util/PhaseSwitching.idl"
#include "carma/util/UserException.idl"


module carma {
module control {

const string SUBARRAY_CONTROL_NAME = "carma.subarrayControl";

exception TimeoutException {
    string errorMsg;
    string fileName;
    short  lineNo;
};

exception InvalidMonitorDataException {
    string errorMsg;
    string fileName;
    short  lineNo;
};

exception MonitorPointNotFoundException {
    string errorMsg;
    string fileName;
    short  lineNo;
};


typedef sequence<float> AzElSeq;

typedef sequence<double> RaDecSeq;

struct AntennaAssignment {
    short  carmaAntennaNo;

    string carmaAntennaName;

    string typedAntennaName;
};



typedef sequence< AntennaAssignment > AntennaAssignmentSeq;


struct MonitorPointValue {
    string                                name; // Full, canonical name
    string                                stringValue;
    carma::monitor::TransportMonitorValue value;
    boolean                               valid;
    boolean                               found;
};
typedef sequence<MonitorPointValue> SeqMonitorPointValue;

enum Aperture {
    APERTURE_OPTICAL,    
    APERTURE_RADIO1MM,   
    APERTURE_RADIO3MM,   
    APERTURE_RADIO1CM    
};

enum WaitItem {
    WAIT_INTERVAL,       
    WAIT_ONSOURCE,       
    WAIT_TUNED,          
    WAIT_CALIBRATOR,     
    WAIT_INTEG,          
    WAIT_TILT,           
    WAIT_CENTROID,       
    WAIT_OPTICS,          
    WAIT_CORRELATOR       
};

enum WaitCondition {
    WAIT_SINGLE,     
    WAIT_ALL,         
    WAIT_COUNT        
};


enum ImagingType {
   IMG,  
   SNR   
};

enum ScriptStateType {
   RUNNING,    
   COMPLETED,  
   CRASHED,    
   CANCELED    
};

enum BlankFlagPref {
    PREFER_BLANKING,

    PREFER_FLAGGING,

    FORCE_BLANKING,

    FORCE_FLAGGING
};

enum PointStatusType {
   ON_SOURCE,  
   OFF_SOURCE  
};

enum NearestActionType {
   ACTION_INCLUDE , 
   ACTION_EXCLUDE   
};

enum ShadowingType {
  SHADOW_INTERNAL,
  SHADOW_SWEPTVOLUME
};

struct ComponentReady {
    SeqShort ready;
    SeqShort notready;
};

typedef ComponentReady AntennaReady;
typedef ComponentReady BandReady;

struct AddAntennaResult {
    SeqShort actuallyAdded;
    SeqShort alreadyInSubarray;
    SeqShort ownedByOtherSubarrays;
};

struct RemoveAntennaResult {
    SeqShort actuallyRemoved;
    SeqShort alreadyInMaint;
    SeqShort ownedByOtherSubarrays;
};

struct FluxMeasurement {
    string source;
    float flux;
    float rms;
    float freq;
    float daysback;
    string date;
};

//================================================================

interface SubarrayControl: OpticalTelescope, Drives, SignalPath, 
              carma::util::PhaseSwitching {

    string query(in string monitorName) raises(carma::util::UserException,
            MonitorPointNotFoundException);

    string queryString(in string monitorPointName)
        raises(carma::util::UserException,
            InvalidMonitorDataException, MonitorPointNotFoundException);

    double queryDouble(in string monitorPointName)
        raises(carma::util::UserException,
            InvalidMonitorDataException, MonitorPointNotFoundException);

    long queryInt(in string monitorPointName)
        raises(carma::util::UserException,
            InvalidMonitorDataException, MonitorPointNotFoundException);

    SeqFloat queryComplex(in string monitorPointName)
        raises(carma::util::UserException,
            InvalidMonitorDataException, MonitorPointNotFoundException);

    boolean queryBool(in string monitorPointName)
        raises(carma::util::UserException,
            InvalidMonitorDataException, MonitorPointNotFoundException);

    SeqMonitorPointValue queryMonitorPoint(in SeqString monitorComponent)
        raises(carma::util::UserException);

    void setMonitorPointReal(in string name, in double value)
        raises(carma::util::UserException);

    void setMonitorPointInvalid(in string name)
        raises(carma::util::UserException);

    FluxMeasurement queryFlux(in string source,
               in float freq,
               in float deltaFreq,
               in float deltaTime)
        raises(carma::util::UserException);

    float queryMag(in string starName)
        raises(carma::util::UserException);
        
// ------------ Project database commands --------------------

    carma::observertools::ProjectSequence queryProject(
              in carma::observertools::ItemValueSequence ivSeq )
        raises(carma::util::UserException,
               carma::observertools::ProjectDatabaseException);

    void projectOscriptAdd(  in string project,
                             in string obsblock,
                             in string subobsblock,
                             in string scriptFile,
                             in string catalogFile )
        raises(carma::util::UserException);


    boolean projectEdit( in string project,
                         in string obsblock,
                         in string subobsblock,
                         in short trial,
                         in carma::observertools::ItemValueSequence ivSeq,
                         in carma::observertools::EditStatus action)
        raises(carma::util::UserException,
               carma::observertools::ProjectDatabaseException);

    short projectRun(in string projectID, in string obsblock,
                     in string subObsblock, in boolean isCommissioning,
                     in boolean isDualCorr, in string arrayConfig1,
                     in string arrayConfig2,
                     in string scriptFile, in string catalogFile)
        raises(carma::util::UserException,
               carma::observertools::ProjectDatabaseException);
// ---------------------------------------------------------

    long getSubarrayNo() raises(carma::util::UserException);

    string getSubarrayName() raises(carma::util::UserException);

    void pad(in short padNo, in short carmaAntNo)
         raises(carma::util::UserException);

    void padOffset(in float east, in float north, in float up,
                   in short carmaAntNo) raises(carma::util::UserException);

    void antennaOffset(in float east, in float north, in float up,
                  in short carmaAntNo) raises(carma::util::UserException);

    PadOffsets convertBaseline(in double x, in double y, in double z,
                               in short carmaAntNo)
              raises(carma::util::UserException);

    void setAntPosFilename( in string filename )
        raises( carma::util::UserException );

    void axisNonintersection(in float offset,
                  in short carmaAntNo) raises(carma::util::UserException);

    void noiseSource(in boolean state, in boolean isReference) 
        raises(carma::util::UserException);

    void noisePreset( )
        raises(carma::util::UserException);

    void noiseAtten(in unsigned short atten)
        raises(carma::util::UserException);

    void quadmodAtten(in unsigned short atten)
        raises(carma::util::UserException);

    void delay(in float offset, in short carmaAntNo)
         raises(carma::util::UserException);

    void adjustableDelay(in float offset,
                         in SeqShort   carmaAntNoSeq)
         raises(carma::util::UserException);

    void delayDifference(in float diff, in short carmaAntNo,
                           in carma::antenna::common::RxControl::Type rx,
// argh, this should really be carma::antenna::common::RxControl::Pol_Type pol,
// I'll have to change this, but right now it has a ripple effect that
// I don't want to deal with (fitDelays, etc) . MWP
                           in BlockDCPolarizationType pol)
         raises(carma::util::UserException);

    double doppler(in string source)
         raises(carma::util::UserException);

    void antennaIFatten(in double power, in short ifNum,
                        in SeqShort carmaAntNoSeq,
                        in boolean invalidateTsys )
         raises(carma::util::UserException);

    void antennaIFpower(in double power, in SeqShort carmaAntNoSeq)
        raises(carma::util::UserException);

    void antennaIFpresetPower(in SeqShort carmaAntNoSeq)
         raises(carma::util::UserException);

    void storeAntennaIFattenAmbient(in SeqShort carmaAntNoSeq)
         raises(carma::util::UserException);

    void psysPreset(in SeqShort carmaAntNoSeq, in short astroBandNo)
         raises(carma::util::UserException);

    void psysLevel(in double level)
         raises(carma::util::UserException);

    void ifoutPreset()
         raises(carma::util::UserException);

    void ifoutLevel(in double level)
         raises(carma::util::UserException);

    void rfPower(in boolean state)
         raises(carma::util::UserException);

    void setInitializationFlag(in boolean state)
         raises(carma::util::UserException);

    boolean getInitializationFlag()
         raises(carma::util::UserException);

    void antennaInitialized(in boolean state, in SeqShort carmaAntNoSeq)
         raises(carma::util::UserException);

 // ======================= Pointing measurement =========================
    void recordPoint(in short carmaAntNo)
         raises(carma::util::UserException);

    AntennaAssignmentSeq getAntennaAssignments( )
         raises(carma::util::UserException);

    AddAntennaResult addAntenna( in SeqShort carmaAntNoSeq,
                                 in boolean  skipAntsOwnedByOthers )
         raises ( carma::util::UserException );

    RemoveAntennaResult removeAntenna( in SeqShort carmaAntNoSeq,
                                       in boolean  skipAntsNotOwnedByMe )
         raises ( carma::util::UserException );

    void tilt(in SeqShort carmaAntNoSeq)
         raises(carma::util::UserException);

    void assignLO(in long loRefNo)
         raises(carma::util::UserException);

    void freq(in double frest, in SidebandType sb, in double fif,
              in string doppler, in string transition)
        raises(carma::util::UserException,
               carma::util::CancelException);

    void qfreq(in double frest, in SidebandType sb, in double fif,
            in string doppler, in string transition)
        raises(carma::util::UserException);

    void refreq(in SeqShort carmaAntNoSeq, in boolean retune)
         raises(carma::util::UserException);

    void refAtten(in unsigned short atten, in short carmaAntNo)
         raises(carma::util::UserException);

    SeqDouble harmonics(in double freq)
         raises(carma::util::UserException);

    void setConfigName(in string name)
         raises(carma::util::UserException);

    void setObsblock(in string project, in string obsblock,
                     in string subObsblock, in long trial)
         raises(carma::util::UserException);

    void setAllObsblocks(in string project1, in string obsblock1,
                         in string subObsblock1, in long trial1,
                         in string project2, in string obsblock2,
                         in string subObsblock2, in long trial2 )
      raises(carma::util::UserException);
                 
    void project(in string project)
         raises(carma::util::UserException);

    void obsblock(in string obsblock)
         raises(carma::util::UserException);

    void subObsblock(in string subObsblock)
         raises(carma::util::UserException);

    void trial(in long number)
         raises(carma::util::UserException);

    void resetProjectAndObsblock( )
         raises(carma::util::UserException);

    void setConstraints (
            in ImagingType imgType,
            in short minAnts,
            in float calMaxTime,
            in float calMaxRms,
            in float maxTsys,
            in float maxRmsPathLength,
            in float maxTau,
            in float maxDecor,
            in float requiredRms
         )
         raises(carma::util::UserException);

    void setDefaultConstraints ( )
         raises(carma::util::UserException);

    void setIntent(in string sourceName, in string purpose,
                   in boolean selfcal, in boolean fastSwitch)
         raises(carma::util::UserException);


    boolean isCommissioning( in string project )
         raises(carma::util::UserException);
    void camera( in carma::antenna::common::SwitchState state,
                 in SeqShort carmaAntNoSeq)
         raises(carma::util::UserException);

    void elevLimit(in float limit)
         raises(carma::util::UserException);

    string info(in string sourceName)
         raises(carma::util::UserException);

    RaDecSeq getRaDec(in string sourceName)
         raises(carma::util::UserException);

    AzElSeq azel(in string sourceName, in double minutes)
         raises(carma::util::UserException);

    boolean isUp(in string sourceName)
         raises(carma::util::UserException);

    float whenDown(in string sourceName)
         raises(carma::util::UserException);

    float whenUp(in string sourceName)
         raises(carma::util::UserException);

    float whenTransit(in string sourceName)
         raises(carma::util::UserException);

    string whazUp()
         raises(carma::util::UserException);

    string whazUpOptical()
         raises(carma::util::UserException);

    void integrate(in double intTime, in long numInts,
                   in double gap, in boolean science)
         raises(carma::util::UserException);

    void cancel()
         raises(carma::util::UserException);

    void fringeTracking(in boolean on)
         raises(carma::util::UserException);

    void phaseSwitching(in boolean on, in short chanNo)
         raises(carma::util::UserException);

    void lrPhaseOffsetMode(in boolean on)
         raises(carma::util::UserException);

    void lrPhase(in float phaseOffset, in short carmaAntNo)
         raises(carma::util::UserException);

    void lrRate(in float phaseRate, in short carmaAntNo)
         raises(carma::util::UserException);

    void cal(
        in carma::antenna::common::CalibratorControl::Position cal,
        in SeqShort carmaAntNoSeq) raises(carma::util::UserException);

    void tiltZeros(in float aftForward, in float leftRight, in short carmaAntNo)
         raises(carma::util::UserException);

    void aperturePointingConstants(in Aperture ap,
        in float az, in float el, in float sag, in short carmaAntNo)
         raises(carma::util::UserException);

    void phaseOffset(in float phase, in short bandNo,
                     in short antenna1No, in short antenna2No)
         raises(carma::util::UserException);

    void applyTsys(in boolean on)
         raises(carma::util::UserException);

    void applyFlux(in boolean on)
         raises(carma::util::UserException);

    void applyFocus(in boolean on)
         raises(carma::util::UserException);

    void setDecimationMode(in DecimationMode mode, 
                           in unsigned short astrobandNo)
         raises(carma::util::UserException);

    void doIVcurve( in carma::antenna::common::RxControl::Type rx,
                    in carma::antenna::common::RxControl::Pol_Type pol,
                    in float startVjInMv,
                    in float stopVjInMv,
                    in float stepVjInMv,
                    in unsigned short deltaInMs,
                    in boolean doTotalPower,
                    in SeqShort carmaAntNoSeq )
        raises ( carma::util::UserException );

    carma::antenna::common::IVCurve getIVcurve(in short carmaAntNo)
        raises(carma::util::UserException);

    ComponentReady wait(in WaitItem item, in SeqShort carmaComponentNoSeq,
                in float timeout,
                in WaitCondition condition,
                in short count)
         raises(carma::util::UserException,
                carma::util::CancelException,
                carma::control::TimeoutException,
                carma::control::InvalidMonitorDataException);

    void focusZ(in float position, in short carmaAntNo)
         raises(carma::util::UserException);

    void focusX(in float position, in short carmaAntNo)
         raises(carma::util::UserException);

    void focusY(in float position, in short carmaAntNo)
         raises(carma::util::UserException);

    void equatOffset( in double   dra,
                      in double   ddec,
                      in SeqShort carmaAntNoSeq,
                      in boolean  affectPhaseCenter,
                      in boolean  whileIntegrating)
         raises(carma::util::UserException);

    void phaseCenterOffset(in double dra, in double ddec)
         raises(carma::util::UserException);

    void passiveLO(in double freq)
         raises(carma::util::UserException);

    void polarization(
        in carma::antenna::common::PolarizationControl::State polState,
        in SeqShort carmaAntNoSeq)
         raises(carma::util::UserException);

    AntennaReady tsys()
        raises(carma::util::UserException);


      void configAstroBand( in short astrobandNo,
              in string astroBandConf,
              in carma::util::CorrelatorBandWidthType bandwidth,
              in double fcenter,
              in SidebandType sb,
              in double frest,
              in double imagefrest,
              in boolean online,
              in string transition, in string imageTransition,
              in carma::util::CorrelatorBitType bits
              )
        raises(carma::util::UserException);

    void assertCorrelatorConfiguration()
        raises(carma::util::UserException);

    void clearAstroBand(in short astrobandNo)
        raises(carma::util::UserException);
  
    void enableCorrelation( in SeqShort bandNoSeq ,
                            in boolean correlationsEnabled )
        raises(carma::util::UserException);

    void astroBandOnline(in short astrobandNo, in boolean online)
        raises(carma::util::UserException);

    void optimizeThresholds( in SeqShort bandNoSeq )
     raises(carma::util::UserException);

    void flattenPhases( in SeqShort bandNoSeq )
     raises(carma::util::UserException);

    void calibrateSpectra( in SeqShort bandNoSeq ,
                           in boolean noiseEnabled,
                           in float intTime ,
                           in boolean cache,
                           in boolean enable)
     raises(carma::util::UserException);

    boolean checkConfig(in boolean quiet)
        raises(carma::util::UserException);

    SeqShort getCorrelatorBandNoSeq( in SeqShort astroBandNoSeq, 
                                     in boolean includeOfflineBands )
        raises(carma::util::UserException);
    double lst()
     raises(carma::util::UserException);

    double mjd(in double seconds)
     raises(carma::util::UserException);

    string lstString()
     raises(carma::util::UserException);

    string times()
     raises(carma::util::UserException);

    void reconnect(in boolean force) raises(carma::util::UserException);

    void ucat(in string catalog) raises(carma::util::UserException);

    void useAdjustableDelay( in boolean useIt, in SeqShort carmaAntNoSeq )
         raises(carma::util::UserException);

    void useIonosphericDelay( in boolean useIt, in SeqShort carmaAntNoSeq )
         raises(carma::util::UserException);

    void useGeometricDelay( in boolean useIt, in SeqShort carmaAntNoSeq )
         raises(carma::util::UserException);

    void useHeightDelay( in boolean useIt, in SeqShort carmaAntNoSeq)
         raises(carma::util::UserException);

    void useTroposphericDelay( in boolean useIt, in SeqShort carmaAntNoSeq )
         raises(carma::util::UserException);
    void useThermalDelay( in boolean useIt, in SeqShort carmaAntNoSeq )
         raises(carma::util::UserException);

    void sbratio(in float ratio, in SeqShort carmaAntNoSeq )
     raises(carma::util::UserException);

    void radioAperture(in boolean useRadio, in SeqShort carmaAntNoSeq)
     raises(carma::util::UserException);

    void jyperk(in float gain, in short carmaAntNo)
         raises(carma::util::UserException);

    void pointStatus(in PointStatusType status, in SeqShort carmaAntNoSeq)
         raises(carma::util::UserException);

    void vj( in carma::antenna::common::RxControl::Pol_Type pol,
             in float vj,
             in short carmaAntNo )
         raises(carma::util::UserException);

    void ij( in carma::antenna::common::RxControl::Pol_Type pol,
             in float ij,
             in short carmaAntNo )
         raises(carma::util::UserException);

    AntennaReady bogus(in float numSeconds)
         raises(carma::util::UserException);

    void testAntHandles( in double   aSeconds,
                         in double   bSeconds,
                         in long     whichTest,
                         in double   lateAfterSeconds,
                         in SeqShort carmaAntNoSeq )
         raises( carma::util::UserException );

    void setTraceLevel( in short traceLevel )
         raises( carma::util::UserException );
    double lineFreq(in string line)
        raises(carma::util::UserException);

    double transitionFreq(in string molecule, in string transition)
        raises(carma::util::UserException);


    void alarm(in boolean state, in string alarmName)
        raises(carma::util::UserException);

    void alarmEnable(in boolean state)
        raises(carma::util::UserException);

    void alarm1mm(in boolean state)
        raises(carma::util::UserException);

    void comment(in string obsComment)
        raises(carma::util::UserException);
    void log(in string entry)
        raises(carma::util::UserException);

    void logError(in string entry)
        raises(carma::util::UserException);

    boolean getScriptBool(in short index)
        raises(carma::util::UserException);

    void setScriptBool(in short index, in boolean value)
        raises(carma::util::UserException);

    double getScriptDouble(in short index)
        raises(carma::util::UserException);

    void setScriptDouble(in short index, in double value)
        raises(carma::util::UserException);

    long getScriptInt(in short index)
        raises(carma::util::UserException);

    void setScriptInt(in short index, in long value)
        raises(carma::util::UserException);

    string getScriptString(in short index)
        raises(carma::util::UserException);

    void setScriptString(in short index, in string value)
        raises(carma::util::UserException);

    void appendScriptString(in short index, in string value)
        raises(carma::util::UserException);

    void addScriptHistory(in string value)
        raises(carma::util::UserException);

    string getScriptHistory()
        raises(carma::util::UserException);

    boolean getScriptHistoryFull()
        raises(carma::util::UserException);

    void clearScriptAll()
        raises(carma::util::UserException);

    void setScriptName(in string name)
        raises(carma::util::UserException);

    string getScriptName()
        raises(carma::util::UserException);

    void setScriptState(in ScriptStateType state)
        raises(carma::util::UserException);

    ScriptStateType getScriptState()
        raises(carma::util::UserException);

    void setFaultSystemDriveErrorPreference( in carma::fault::EffectPreference inPref )
        raises ( carma::util::UserException );

    void disableFaultSystemAlarms( in SeqString inMonitorPointNames )
        raises ( carma::util::UserException );

    void restoreFaultSystemAlarms( in SeqString inMonitorPointNames )
        raises ( carma::util::UserException );

    void setFaultSystemAlarmEnableState( in boolean inStateIsOn )
        raises ( carma::util::UserException );

    void resetTimeSinceLastIntegration()
        raises (carma::util::UserException);

    void saveControlSubsystemState( in string filename )
        raises (carma::util::UserException);

    void restoreControlSubsystemFromFile( in string filename )
        raises (carma::util::UserException);

    void restorationInProgress( in boolean restoring )
        raises (carma::util::UserException);

    void signalControlSubsystemRestored( )
        raises (carma::util::UserException);

    NearestInfoSeq getNearest( in string source,
                               in float elMin, in float elMax,
                               in SeqString sourceList,
                               in NearestActionType action,
                               in short numReturn,
                               in boolean ignoreNorthSouth,
                               in string coordSys,
                               in boolean optical,
                               in float fluxLimit,
                               in float frequency )
      raises (carma::util::UserException);

    void startTrack()
        raises (carma::util::UserException);

  void addBirdie(
    in unsigned long type,
    in unsigned short band,
    in unsigned short input1,
    in unsigned short input2)
    raises (carma::util::UserException);

  void removeBirdie(
    in unsigned long type,
    in unsigned short band,
    in unsigned short input1,
    in unsigned short input2)
    raises (carma::util::UserException);

  void clearBirdies(
    in unsigned long type)
    raises (carma::util::UserException);

  void addCorrelator(in unsigned long type)
    raises (carma::util::UserException);

  void removeCorrelator(in unsigned long type)
    raises (carma::util::UserException);

  boolean subarrayOwnsCorrelator(in long subarrayNo, in unsigned long type)
    raises (carma::util::UserException);

  boolean subarrayOwnsSingleCorrelator(in long subarrayNo)
    raises (carma::util::UserException);

  boolean subarrayOwnsNoCorrelator(in long subarrayNo)
    raises (carma::util::UserException);

  string astrobandCorrelator(in long astrobandNo)
    raises (carma::util::UserException);

  string ownedCorrelator(in long subarrayNo)
    raises (carma::util::UserException);

  SeqShort getAstroBandsForConfiguration(in string confName)
    raises (carma::util::UserException);

  void setInvalidationForMosaics( in boolean invalidate )
    raises (carma::util::UserException);

  boolean isShadowedNow(in short carmaAntennaNo, in ShadowingType type, in double diameterFraction)
    raises(carma::util::UserException);

  boolean isShadowedHaDec(in short carmaAntennaNo, in double hourAngleHours, in double decDegrees, in ShadowingType type, in double diameterFraction)
    raises(carma::util::UserException);

  boolean isShadowedSource(in short carmaAntennaNo, in string sourceName, in double lstHours, in ShadowingType type, in double diameterFraction)
    raises(carma::util::UserException);
    
  // ===================================================
  // Repetitive task methods
   
  void setRepTaskName(in long taskIndex, in string taskName)
    raises(carma::util::UserException);    
  void setRepTaskInterval(in long taskIndex, in double interval)
    raises(carma::util::UserException);    
  void setRepTaskRemind(in long taskIndex, in double remind)
    raises(carma::util::UserException);    
  void setRepTaskAuto(in long taskIndex, in double auto)
    raises(carma::util::UserException);    
  void setRepTaskCompleted(in long taskIndex, in double mjd)
    raises(carma::util::UserException);    
   
   /* ----------------------------------------------------------------- */
    // Testing
    string testMessageSize(in unsigned long size)
        raises(carma::util::UserException);
};




}; // end control
}; // end carma

#endif  // end of conditional include