HLA Time Regulating Talk Example

Table of Contents

• Time Regulation
• HLA Time Regulating Talk Example Code

Time Regulation

This program is a time regulating version of TalkRPR. It gets an initial time when time regulation is enabled and then advances for about 10 time units. Movement of the entity is not even. It sends one interaction. Time regulation is turned off when the federate is ready to leave; this will allow time constrained federates to advance at that point. It is possible, and usually desirable, to move time forward as the simulation progresses. However, we choose not to here.

HLA Time Regulating Talk Example Code

/****************************************************************************
 * Copyright (c) 1992-2025 MAK Technologies, Inc
 * All rights reserved.
 ****************************************************************************/


#ifdef DtHLA

#include <vl/exerciseConn.h>
#include <vl/exerciseConnInitializer.h>
#include <vl/topoView.h>
#include <vlutil/vlProcessControl.h>
#include <vlutil/vlKeyboard.h>
#include <vlpi/entityTypes.h>
#include <vl/entityPublisher.h>
#include <vl/entityStateRepository.h>
#include <vl/fireInteraction.h>
#include <vl/vrlFederateAmbassador.h>
#include <vlutil/vlMiniDumper.h>
#include <vlutil/vlSimpleKeyboard.h>

#if DtHLA_1516
   #if DtHLA_1516_EVOLVED
      #include <RTI/time/HLAfloat64Time.h>
      #include <RTI/time/HLAfloat64Interval.h>
   #else
      #include <RTI/logicalTimeImpl.h>
      #include <RTI/logicalTimeIntervalImpl.h>
   #endif
#else
   #include <fedtime.hh>
#endif


DtSimpleKeyboard input;
#if DtHLA_1516
void timeAdvanceRequestCb(const RTI::LogicalTime &, void *);
void timeRegulationEnabledCb(const RTI::LogicalTime &, void *);
#else
void timeAdvanceRequestCb(const RTI::FedTime &, void *);
void timeRegulationEnabledCb(const RTI::FedTime &, void *);
#endif


// Globals
bool theTimeRegOn(false);
bool theTimeMoved(false);

#if DtHLA_1516
   #if DtHLA_1516_EVOLVED
      HLAfloat64Time theGlobalFedTime;
      const HLAfloat64Interval theLookAhead(2.0);
      const HLAfloat64Interval theFedTimeAdvance(0.5);
   #else
      LogicalTimeImpl theGlobalFedTime;
      const LogicalTimeIntervalImpl theLookAhead(2.0);
      const LogicalTimeIntervalImpl theFedTimeAdvance(0.5);
   #endif
#else
RTIfedTime theGlobalFedTime;
const RTIfedTime theLookAhead(2.0);
const RTIfedTime theFedTimeAdvance(0.5);
#endif

int main( int argc, char* argv[] )
{
   // Used for error handling
   DtINIT_MINIDUMPER( "TimeRegulator" );

   DtVrlApplicationInitializer appInit( argc, argv, "VR-Link timeRegulator" );

   // Set the default FED File, executable, and version
   appInit.setFedFileName( DtDefaultRpr2Fom );
   appInit.setExecName( "MAK-One-2025" );
   appInit.setRprFomVersion( 2.0 );
   appInit.setRprFomRevision( 1 );

#ifdef DtHLA_1516_EVOLVED
   std::vector<DtString> fomModules;
   std::vector<DtString> fomModuleFromCommandLine;
   appInit.fomModules(fomModuleFromCommandLine);

   fomModules.push_back("NETN-Physical.xml");

   fomModules.insert(fomModules.end(), fomModuleFromCommandLine.begin(), fomModuleFromCommandLine.end());
   appInit.setFomModules(fomModules);
#endif

   appInit.parseCmdLine();
   DtExerciseConn exConn( appInit );

   DtInfo << "Time Management examples require attributes in FOM to be set to TimeStamp order." << std::endl;

   // Register for
   // 1) time advance grants, to let us move time forward.
   exConn.fedAmb()->addTimeAdvanceGrantCb( timeAdvanceRequestCb, 0 );
   // 2) time regulation turning on, because we cant start simulating until
   // it goes on.
   exConn.fedAmb()->addTimeRegulationEnabledCb( timeRegulationEnabledCb, 0 );

#if DtHLA_1516
   exConn.rtiAmb()->enableTimeRegulation(theLookAhead);
#else
   exConn.rtiAmb()->enableTimeRegulation(theGlobalFedTime, theLookAhead);
#endif

   // Tell the Exercise Connection that all our messages should be
   // sent TSO. If we want to send a message non TSO, this can be turned on
   // and off throughout the life of the application.
   exConn.setSendFedTime(true);

   // We have requested Time regulation, as we don't know what time
   // will begin as, we need to wait before moving forward.
   while(!theTimeRegOn)
   {
      // Wait and query the RTI
      exConn.drainInput();
      DtSleep(0.05);
   }

   DtVector position(0.0, 0.0, 0.0);
   DtVector32 velocity(10.0, 0.0, 0.0);
   DtEntityType *f18Type = new DtEntityType(DtPlatform, DtPlatformDomainAir, DtUnitedStates, DtFighter, DtF18, 0, 0);

   // Create an entity publisher for the entity we are simulating.
   DtEntityPublisher *entityPub = new DtEntityPublisher(*f18Type, &exConn,
                DtDrDrmRvw, DtForceFriendly, DtEntityPublisher::guiseSameAsType());

   // Hold on to its state repository, where we can set data.
   DtEntityStateRepository *esr = entityPub->entityStateRep();

   // Create a topographic view on the state repository, so we
   // can set position information in topographic coordinates.
   double refLatitude  = DtDeg2Rad(  35.699760);
   double refLongitude = DtDeg2Rad(-121.326577);
   DtTopoView topoView(esr, refLatitude, refLongitude);
   topoView.setLocation(position);
   topoView.setVelocity(velocity);

   // We can use the ESR to set state.
   esr->setMarkingText("VR-Link");
#if DtHLA_1516
   DtTime timeAdvanceInterval = theFedTimeAdvance.getInterval();
#else
   DtTime timeAdvanceInterval = theFedTimeAdvance.getTime();
#endif

   // messages we send out will be tagged with the Sim Time.
   // with TSO messages as a time regulator we make a contract
   // to send no messages earlier than globalFedTime + Lookahead.
   // Lookahead may by 0 however, this imposes stress on the RTI and
   // should be avoided.
#if DtHLA_1516
   DtTime lookahed = theLookAhead.getInterval();
   DtTime simTime = theGlobalFedTime.getTime() + lookahed;
#else
   DtTime lookahed = theLookAhead.getTime();
   DtTime simTime = theGlobalFedTime.getTime() + lookahed;
#endif

   // Initialize VR-Link time.
   exConn.clock()->setSimTime(simTime);

   // Send a Fire Interaction.
   DtInfo << "\nSending Interaction at Time: " << simTime << "\n\n";

   DtFireInteraction fire;
   fire.setAttackerId(entityPub->globalId());
   exConn.sendStamped(fire);

   int updateCount = 0;
   DtTime endTime = simTime + 10.0;
   DtTime lastTime = simTime;

   while (simTime <= endTime)
   {
      if (input.keybrdTick() == -1)
         break;

      if (theTimeMoved)
      {
         theTimeMoved = false;
         DtTime dt = simTime - lastTime;

         // Tell VR-Link the current value of simulation time.
         exConn.clock()->setSimTime(simTime);

         position[0] += velocity[0] * dt;
         position[1] = simTime;
         position[2] = updateCount++;

         topoView.setLocation(position);
         topoView.setVelocity(velocity);

         entityPub->tick();

         // Print the fed time and position.
         // Since it returns a DtString, we need to force it to const char* with a cast.
         DtInfo << "Fed Time: " << theGlobalFedTime.getTime()
            << " Sim Time: " << simTime
            << " Pos: " << topoView.location().string() << '\n'
            << "--------" << std::endl;

         lastTime = simTime;
         simTime += timeAdvanceInterval;

#if DtHLA_1516
#if DtHLA_1516_EVOLVED
         HLAfloat64Time reqTime(theGlobalFedTime);
#else
         LogicalTimeImpl reqTime(theGlobalFedTime);
#endif
         reqTime = theGlobalFedTime;
         reqTime += theFedTimeAdvance;
         exConn.rtiAmb()->timeAdvanceRequest(reqTime);
         DtInfo << "requesting time: " << (theGlobalFedTime.getTime() + theFedTimeAdvance.getInterval()) << std::endl;
#else
         exConn.rtiAmb()->timeAdvanceRequest(theGlobalFedTime + theFedTimeAdvance);
         DtInfo << "requesting time: " << (theGlobalFedTime.getTime() + theFedTimeAdvance.getTime()) << std::endl;
#endif
      }

      // Suspend for longer and longer periods of time
      // but if we join late lets not make it obnoxious
      exConn.drainInput();
      DtSleep(((int)simTime%10) + 1);
   }

   // Delete these items before you turn off time regulation. If
   // time reg goes off (remember, it takes affect right away) then
   // the deleteObject message will not have a time stamp and may be
   // delivered BEFORE the discoverObject is issued.
   // Make sure to increase simTime once again so that we are not trying to delete
   // at the same time as we last updated.
   exConn.clock()->setSimTime(simTime+5);
   delete f18Type;
   delete entityPub;

   // Disable time regulation. The RTI should be able to figure this out
   // but its nice to be polite.
   exConn.rtiAmb()->disableTimeRegulation();


      // Drain Input to work around a potential bug in the RTI where
      // resigning from the Exercise will delete all objects with TSO
   exConn.drainInput();

   return 0;
}

void timeAdvanceRequestCb(
#if DtHLA_1516
   const RTI::LogicalTime &aTime,
#else
   const RTI::FedTime &aTime,
#endif
   void *userData)
{
   theGlobalFedTime = aTime;
   theTimeMoved = true;

   DtInfo << "Time Advance Grant to: " << theGlobalFedTime.getTime() << std::endl;
   DtInfo.flush();
}

void timeRegulationEnabledCb(
#if DtHLA_1516
   const RTI::LogicalTime &aTime,
#else
   const RTI::FedTime &aTime,
#endif
   void *userData)
{
   theGlobalFedTime = aTime;
   theTimeRegOn = true;
   theTimeMoved = true;

   DtInfo << "\nTime Regulation Enabled at time: " << theGlobalFedTime.getTime() << "\n\n";
   DtInfo.flush();
}

#else    // !DtHLA

#include <iostream>

int main()
{
   std::cout << "Time Management Is only available in HLA" << std::endl;;
   return 0;
}

#endif   // !DtHLA