Skip to content

Updating Scripts For Newer Versions

Aimsun Next 24 changes

The following is a list of all the functions that have changed between Aimsun Next 23 and Aimsun Next 24 in order to help update old scripts easily. The classes with changes are:

GKControllerParsOCIT Class

The signature of the following functions: 

void setProtocolFilepath( const QString& filepath );
const QString& getProtocolFilepath() const;
has been replaced by: 
void setProtocolFilepath( const GKFilePath& filepath );
const GKFilePath& getProtocolFilepath() const;

GKControllerParsVSPLUS Class

The type of the following members: 

QString informationFile;
QString parametersFile;
has changed to: 
GKFilePath informationFile;
GKFilePath parametersFile;

GKControllerParsSitrafficOffice Class

The signature of the following functions: 

void setConfigurationFolder( const QString& filepath );
const QString& getConfigurationFolder() const;
has been replaced by: 
void setConfigurationFolder( const GKFilePath& filepath );
const GKFilePath& getConfigurationFolder() const;

GKFilePath Class

The GKFilePath class has been added. A filesystem path for a file in the project with some utility functions.

GKFunctionCostContext Class

The attributes that were deprecated ( experiment, userClass, time, timeSta and iteration) have been removed and they need to be accessed using the functions that are provided.

    const GKGenericExperiment   * getExperiment() const;
    const GKBaseObject          * getUserClass() const;
    double                      getTime() const;
    double                      getTimeSta() const;
    GKMobileAgent               * getVehicle() const;
    GKTripPurpose               * getPurpose() const;

GKNode Class

The signature of the function getMinimalPolygons has been modified, now it has a third optional parameter curvedGeometry to get the polygons with curved or straight lines joining the sections. 

QVector<GKPoints> getMinimalPolygons( const GKGenericScenario * scenario, bool includeNotDrawn = true, bool curvedGeometry = true ) const;

GKObject Class

The signature of the function clone has been modified, now it has a second optional parameter temporary. 

virtual GKObject * clone( bool addItToModel = true, bool temporary = false ) const;

GKTrafficDemand Class

The function `getTotalTrips now works with OD Matrices and Traffic States.

GKTrafficState Class

The following function has been added: 

double getTotalTrips() const;

GKScenarioInputData Class

The signature of the following function: 

const QList< QPair<QString,QString> > & getExtensions() const;
has been replaced by: 
const QList< QPair<GKFilePath,QString> > & getExtensions() const;

GKSection Class

The following functions to query the state of the geometry given a scenario or experiment have been added: 

GKNode * getOrigin( const GKGenericScenario* scenario ) const;
GKNode * getDestination( const GKGenericScenario* scenario ) const;

GKNode * getOrigin( const GKGenericExperiment* experiment ) const;
GKNode * getDestination( const GKGenericExperiment* experiment ) const;

GKSystem Class

The following function has changed behaviour: 

QString tryToPutVariablePath( const QString & fileName, GKModel * model = nullptr ) const;
Now it only replaces the path for PLUGINS_HOME. For $MODEL_HOME use a relative path.

DynamicDepartureAdjustmentExperimentResult Class

The DynamicDepartureAdjustmentExperimentResult class has been added. Represents a Dynamic OD Departure Time Rescheduling Result.

DynamicDepartureAdjustmentExperimentResultOutput Class

The DynamicDepartureAdjustmentExperimentResultOutput class has been added. Represents a Dynamic OD Departure Time Rescheduling Result Output.

MacroExperimentParams Class

The following functions have been added: 

virtual bool getBiCriteriaEnabled() const;
virtual GKColumn* getSectionTollAttr( const GKUserClass* user ) const;
virtual GKColumn* getTurningTollAttr( const GKUserClass* user ) const;

virtual void setBiCriteriaEnabled( bool enabled );
virtual void resetTollAttributes();
virtual void setSectionTollAttr( const GKUserClass* user, GKColumn* col );
virtual void setTurningTollAttr( const GKUserClass* user, GKColumn* col );

GKControlJunction Class

A new parameter has been added for actuated junctions with coordinated phases to define how to apply the offset parameter:

enum OffsetReferencePoint { eBeginningOfFirstCoordinatedPhase, eBeginningOfLastCoordinatedPhase, eEndOfFirstCoordinatedPhase };

void setOffsetReferencePoint(OffsetReferencePoint referencePoint );
OffsetReferencePoint getOffsetReferencePoint() const;

These replace the following functions: 

void setMatchesOffsetWithEndOfPhase( const bool c );
bool getMatchesOffsetWithEndOfPhase() const;

All previous uses must be replaced as follows: 

#junction.setMatchesOffsetWithEndOfPhase(true);
junction.setOffsetReferencePoint(GKControlJunction.eEndOfFirstCoordinatedPhase);

#junction.setMatchesOffsetWithEndOfPhase(false);
junction.setOffsetReferencePoint(GKControlJunction.eBeginningOfFirstCoordinatedPhase);

Aimsun Next 23.0.1 changes

The following is a list of all the classes and functions that have changed or have been added after the release of Aimsun Next 23 Final Release. The classes with changes are:

GKCentroidConfiguration Class

The signature of the following functions: 

static GKCentroidConfiguration * getActualCentroidConfiguration( GKModel *, bool = false );
    void desactivate();
has been replaced by: 
    static GKCentroidConfiguration * getCreateActiveCentroidConfiguration( GKModel *, bool = false );
    void deactivate();

GKPedestrianCentroidConfiguration Class

The signature of the following function: 

    void desactivate();
has been replaced by: 
    void deactivate();

GKPTZonePlan Class

The signature of the following function: 

    void desactivate();
has been replaced by: 
    void deactivate();

NSPReader Class

The NSPReader and related NSPTreeStats classes have been discontinued. If you need to retrieve information from and APA file check the following example.

Aimsun Next 23 changes

The following is a list of all the functions that have changed between Aimsun Next 22 and Aimsun Next 23 in order to help update old scripts easily. The classes with changes are:

GAnyObjectChooser Class

The following function signature has changed from 

void setType( GKModel * amodel, GKType * atype, const ChooserMode & amode, bool listSubTypes = true );
to 
void setType( GKType * atype, const ChooserMode & amode, bool listSubTypes = true );

The chooser is no longer set by calling 

GAnyObjectChooser.eOneObjectList
now you need to call 
GAnyObjectChooser.ChooserMode.eOneObjectList

GKCentroid Class

The following function that was receiving a scenario ID receives now the scenario object: 

    void recalculatePercentages( const GKGenericScenario * scenario );

GKCentroidSplitConnectionToNodeCmd Class

The class GKCentroidSplitConnectionToNodeCmd has been added.

A command to move Centroid Connections from nodes to sections. All connections to/from nodes will be converted to connections to/from the sections connected to that node.

setCentroid function
void setCentroid( GKCentroid* centroid );

GKColumn Class

Information about a GKColumn origin has been added. The following options are recognized:

enum Origin { eUnknown, eDeveloper, eImporter, eUI, eScript };

This information can be set using the following function:

void setOrigin( Origin from, const QString& originDescription = QString() );

To retrieve it, the following functions are available: 

    Origin getOrigin() const;   
    QString getOriginDescription() const;

The following functions have been added to set/get the floating point precision when storing and displaying the value: 

    void setPrecision( int precision );
    int getPrecision() const;

GKControlPlan Class

The following functions have been removed as they are no longer needed:

   void updateMatchesOffset();

   void updateRedToGreenYellowTimes();

GKControllerDetector Class

From now on member "detector" is only available via the following functions:

getDetector

    GKDetector* getDetector() const;

setDetector

    void setDetector( GKDetector* detector );

GKControllerDetector has been split into specialized classes, so the following functions are no longer available:

    void setType( Type value );
    Type getType() const;
These have been moved to GKSCOOTControllerDetector(#GKSCOOTControllerDetector) class.

    bool getSPIP() const;
    void setSPIP( bool sp );
These have been moved to GKSCATSControllerDetector(#GKSCATSControllerDetector) class.

    const QString & getName() const;
    void setName( const QString & aname );

    int getLane() const;
    void setLane( int alane );
These have been moved to GKSCATSRMSControllerDetector(#GKSCATSRMSControllerDetector) class.

GKSCOOTControllerDetector Class

Specialization of GKControllerDetector specific to Yunex UTC controllers.

setType

    void setType( Type value );

getType

    Type getType() const;

GKSCATSControllerDetector Class

Specialization of GKControllerDetector specific to SCATS controllers.

getSPIP

    bool getSPIP() const;

setSPIP

    void setSPIP( bool sp );

GKSCATSRMSControllerDetector Class

Specialization of GKControllerDetector specific to SCATS-RMS controllers.

getName

    const QString & getName() const;

setName

    void setName( const QString & aname );

getLane

    int getLane() const;

setLane

    void setLane( int alane );

OCITControllerDetector Class

Specialization of GKControllerDetector specific to OCIT controllers.

addLine

    void addLine( GKPublicLine* line, GKBusStop* stop, double secondsBeforeDeparture );

getBusStop

    GKBusStop* getBusStop( GKPublicLine* line );

getSecondsBeforeDeparture

    double getSecondsBeforeDeparture( GKPublicLine* transitLine );

setCallingPointType

    void setCallingPointType( Type type );

getCallingPointType

    Type getCallingPointType() const;

SiTrafficApValue Class

Class SiTrafficApValue has been renamed into OCITApValue

GKDrawer Class

The function isHidden now takes a const GView *.

isHidden

virtual bool isHidden( const GView * view ) const;

GKDynamicAdjustmentExperiment Class

Two member functions have been added to allow setting and getting the centroid grouping used:

setCentroidGrouping function

    void    setCentroidGrouping( GKGroupingType* iCentroidGrouping );
getCentroidGrouping function
    GKGroupingType*     getCentroidGrouping() const;

The following function call to set the minimum state threshold has been removed:

setStateThreshold

void setStateThreshold( double iValue );

GKFunctionCostContext Class

The attribute userClass is not recommended to access the GKMobileAgent nor the GKTripPurpose. In order to access the vehicle type and purpose, two new functions can be used: 

    GKMobileAgent * getVehicle() const;
    GKTripPurpose * getPurpose() const;

GKGenerationAttractionVector Class

The following functions have been added to complete the interface of this class:

setCentroidConfiguration

void setCentroidConfiguration( GKCentroidConfiguration * cent );

setCarAvailability

void setCarAvailability( const int iCarAvailability );

GKGeoObject Class

The following function that was receiving a scenario ID receives now the scenario object: 

    virtual bool exists( const GKGenericScenario * scenario ) const;

GKModel Class

getActiveScenarioId

Function name changed: 

quint32 getActiveScenarioId() const;
to 
const GKGenericScenario* getActiveScenario() const;

GKNode Class

The following function that was receiving a scenario ID receives now the scenario object: 

    uint getSignalPos( uint /*idSignal*/, const GKGenericScenario * scenario = nullptr ) const;

GKObject Class

The following function have been added to complete the interface of this class:

cloneAsTemporary

virtual GKObject * cloneAsTemporary( bool addItToModel = true ) const;

GKODMatrix Class

The summary information has been added as Columns. The following new attributes can be used to access them: 

static uint minimumValueAtt;
static uint maximumValueAtt;
static uint emptyCellsCountAtt;
static uint nonEmptyCellsCountAtt;
static uint totalValueAtt;
static uint diagonalTotalValueAtt;
The following functions have been added: 
/** Change matrix internal structure to sparse. Uses less memory if the data has a lot of zeros. */
void setMatrixSparse();

/** Calculate the summary info.
 *  @param canAskUser If true and the external file cannot be found, a dialog asking for the location will be shown. */
void calculateSummary( bool canAskUser = true ) const;

/** Invalidates current summary. */
void invalidateSummary() const;

GKODMatrix& operator +=(const GKODMatrix & iMatrix);
The function ensureMatrixData has a new optional parameter: 
/** Ensures that the matrix has data. In case the matrix is externally stored it restores the content.
 * @param canAskUser If true and the external file cannot be found, a dialog asking for the location will be shown.
 * Returns false if data cannot be restored.*/
bool ensureMatrixData( const QUuid & documentUUID = QUuid(), bool canAskUser = true ) const;

GKPolygon Class

The following functions that were receiving a scenario ID receive now the scenario object: 

    QSet<GKGeoObject*> classifyObjects( const GKGenericScenario * scenario, GKObjectsClassification objsToClassify, GKLayer * layer ) const;
    QSet<GKGeoObject*> classifyObjects( const GKGenericScenario * scenario ) const;
    QSet<GKGeoObject*> classifyObjectsInside( const GKGenericScenario * scenario, GKLayer * layer ) const;
    QSet<GKGeoObject*> classifyObjectsPartiallyInside( const GKGenericScenario * scenario, GKLayer * layer ) const;

GKRoadType

The attribute additionalVolumeAtt has been renamed to sectionAdditionalVolumeAtt.

The following attributes have been added: 

    uint turnAdditionalVolumeAtt
    uint turnPenaltyFunctionAtt;
    uint junctionDelayFunctionAtt;

GKRoute Class

The following function that was receiving a scenario ID receives now the scenario object: 

        virtual bool isCorrect( int * errorID = NULL, int * indexSection = NULL, int * previousSection = NULL, const GKGenericScenario * scenario = nullptr ) const;

GKScenarioInputData Class

Several obsolete functions that were not used when defining the scenario output setting have been removed. The exhaustive list of functions no longer available is: 

    bool getSystemStatistics() const;
    bool getAllPTLinesStatistics() const;
    bool getTransytStatistics() const;
    void setTransytStatistics( bool );
    bool getVehTypeStatistics() const;
    bool getDeviationStatistics() const;
    bool getAllNodesTurnsStatistics() const;
    bool getAllSectStatistics() const;
    bool getEntrancesStatistics() const;
    bool getExitsStatistics() const;
    bool getAllSubPathsStatistics() const;
    bool getAllGroupingsStatistics() const;
    void addSectListStatistics( GKSection* );
    void removeSectListStatistics( GKSection * );
    const QVector<GKSection*> & getSectListStatistics() const;
    void clearSectListStatistics();
    bool isSectionInStatistics( GKSection * ) const;
    void addNodeTurnListStatistics( GKNode * aNode );
    void removeNodeTurnListStatistics( GKNode * aNode );
    const QVector<GKNode *> & getNodeTurnListStatistics() const;
    void clearNodeTurnListStatistics();
    bool isNodeInTurnStatistics( GKNode * aNode ) const;

GKSimulationArea Class

The following function that was receiving a scenario ID receives now the scenario object: 

    void calculateGates( const GKTrafficDemand* trafficDemand, const GKGenericScenario * scenario );

GKTask Class

The following function have been added to give access to the unique identifier of a task: 

const QString & getUUID() const;

GKTimeSerie Class

GKTimeSerie has changed from a dimension + position base to a position base. The GKTimeSerieIndex has disappeared and now only position is used (as unsigned int).

As an example, the function setValue has changed from: 

virtual void setValue( GKTimeSerieIndex index, double value, double deviation = -1.0, double lowerValue = -1.0 )
to 
virtual void setValue( unsigned int interval, double value, double deviation = -1.0, double lowerValue = -1.0 )

All references to dimensions, including the call to: 

int dimensions() const;
have been erased.

A minor note: most output and input values that cannot be negative have been changed from int to unsigned int.

The get aggregated methods, like the sum, have been changed and now they do not accept direct QDateTime values as parameters. As the functions allow a start/end index to the interval, this should be enough.

The functions that used to have a time series reference (&) as a parameter now have a time series pointer instead (*).

Added two functions that allow for the acquisition and check of the null value of the given time series, as it can be different based on the description.

The full list of functions that have disappeared or changed in some way is: 

GKTimeSerie();
unsigned int size() const;
int dimensions() const;
void setDescription( GKTSDescription * aDescription );
enum ExtraInfo { eNone, eDeviation, eBands };
ExtraInfo getExtraInfo() const;
virtual void setValue( GKTimeSerieIndex index, double value, double deviation = -1.0, double lowerValue = -1.0 );
virtual double getValue( GKTimeSerieIndex index, bool * = NULL ) const;
virtual double getDeviation( GKTimeSerieIndex index, bool * = NULL ) const;
virtual double getDeviation( const GKContext & , bool * = NULL ) const;
virtual QPair<double, double> getBand( GKTimeSerieIndex index, bool *valid = NULL ) const;
virtual QPair<double, double> getBand( const GKContext & context, bool *valid = NULL ) const;
double getMean( int dimension, const QDateTime & from = QDateTime(), const QDateTime & to = QDateTime(), bool useDate = true ) const;
double getSum( int dimension, const QDateTime & from = QDateTime(), const QDateTime & to = QDateTime(), bool useDate = true ) const;
double getMax( int dimension, const QDateTime & from = QDateTime(), const QDateTime & to = QDateTime(), bool useDate = true ) const;
double getMin( int dimension = 0, const QDateTime & from = QDateTime(), const QDateTime & to = QDateTime(), bool useDate = true ) const;
void setCustomAggregatedValue( int dimension, double value, double deviation = -1.0 );
double getCustomAggregatedValue( int dimension = 0 ) const;
double getCustomAggregatedDeviation( int dimension = 0 ) const;
double getAggregatedValue( int dimension = 0 ) const;
double getAggregatedDeviation( int dimension = 0 ) const;
double getStdDev( int dimension = 0 ) const;
double getSEMean( const GKTimeSerie & /*serie2*/ ) const;
double getTheilU( const GKTimeSerie & /*serie2*/ ) const;
void getTheilUmUcUs( const GKTimeSerie & /*serie2*/, double /*SEm*/, double * /*Um*/, double * /*Uc*/, double * /*Us*/ ) const;
double getRMS(const GKTimeSerie & /*serie1*/ ) const;

Please read the GKTimeSerie sip file documentation for further details.

GKTraversal Class

The following functions that were receiving a scenario ID receive now the scenario object: 

    void calculateGates( const GKGenericScenario * scenario );
    void calculatePublicTransport( const GKGenericScenario * scenario );

GKType Class

It is no longer possible to use the following functions to add GKColumn to a GKType 

    GKColumn* addColumn( const QString & iname, const GKContents& contents , GKColumn::Type atype,
                        GKColumn::GKColumnType astoreType = GKColumn::eExternalTemporary, bool dynamic = false );

    GKColumn* addColumn( const GKContents& contents , GKColumn::Type atype,
                        GKColumn::GKColumnType astoreType = GKColumn::eExternalTemporary, bool dynamic = false );

    GKColumn * addColumn( const QString & iname, const QString & aname, GKColumn::Type atype,
                            GKColumn::GKColumnType astoreType = GKColumn::eExternal, bool dynamic = false );

instead use the ones ahead...

  • Adds a GKColumn with store type GKColumn::eExternal. 

        GKColumn * addExternalColumn( const QString & iname, const QString & aname, GKColumn::Type atype, GKColumn::Origin from = GKColumn::eDeveloper, const QString& originDescription = QString(), bool dynamic = false, int precision = -1 );

  • Adds a GKColumn with store type GKColumn::eExternalTemporary. 

        GKColumn * addTemporaryColumn( const QString & iname, const QString & aname, GKColumn::Type atype, bool dynamic = false, int precision = -1 );
    GKColumn * addTemporaryColumn( const QString & iname, const GKContents& contents , GKColumn::Type atype, bool dynamic = false, int precision = -1 );
    GKColumn * addTemporaryColumn( const GKContents& contents, GKColumn::Type atype, bool dynamic = false, int precision = -1 );

  • Adds a GKColumn with store type GKColumn::ePython. 

        GKColumn * addPythonFunctionColumn( const GKContents& contents, GKColumn::Type atype, int precision = -1 );
    GKColumn * addPythonFunctionColumn( const QString & iname, const QString & aname, GKColumn::Type atype, int precision = -1 );

DTAManager Class

The following function has been removed: 

    DTAVehicleType * getVehicleType(const DTAUserClass * userclass) const;

All previous uses of that function can now use the existing:

    const DTAVehicleType * getDTAVehicleType() const;

found in the DTAUserClass inside the GKContext.

Example of usage:

context.userClass.getDTAVehicleType()

CMacroStatsManager Class

The following functions have been added in order to access the aggregate statistics output from a Static Assignment through the CMacroStatsManager:

getTotalSectionVolume

double      getTotalSectionVolume( const GKSection& iSection, const bool iWeightedByPCU = true ) const;

getTotalSectionOccupancy

double      getTotalSectionOccupancy( const GKSection& iSection ) const;

getTotalSectionCost

double      getTotalSectionCost( const GKSection& iSection, const bool iWeightedByPCU = true ) const;
getTotalSectionCostComponent
double      getTotalSectionCostComponent( const GKSection& iSection, const GKFunctionComponent& iComponent, const bool iWeightedByPCU = true ) const;

getTotalTurningVolume

double      getTotalTurningVolume( const GKTurning& iTurning, const bool iWeightedByPCU = true ) const;

getTotalTurningPercentage

double      getTotalTurningPercentage( const GKTurning& iTurning, const bool iWeightedByPCU = true ) const;

getTotalTurningCost

double      getTotalTurningCost( const GKTurning& iTurning, const bool iWeightedByPCU = true ) const;

getTotalTurningCostComponent

double      getTotalTurningCostComponent( const GKTurning& iTurning, const GKFunctionComponent& iComponent, const bool iWeightedByPCU = true ) const;

getTotalTrajectoryVolume

double      getTotalTrajectoryVolume( const GKSuperNodeTrajectory& iTrajectory, const bool iWeightedByPCU = true ) const;

getTotalTrajectoryPercentage

double      getTotalTrajectoryPercentage( const GKSuperNodeTrajectory& iTrajectory, const bool iWeightedByPCU = true ) const;

getTotalTrajectoryCost

double      getTotalTrajectoryCost( const GKSuperNodeTrajectory& iTrajectory, const bool iWeightedByPCU = true ) const;

getTotalTrajectoryCostComponent

double      getTotalTrajectoryCostComponent( const GKSuperNodeTrajectory& iTrajectory, const GKFunctionComponent& iComponent, const bool iWeightedByPCU = true ) const;

getTotalConnectionVolume

double      getTotalConnectionVolume( const GKCenConnection& iConnection, const bool iWeightedByPCU = true ) const;

getTotalConnectionCost

double      getTotalConnectionCost( const GKCenConnection& iConnection, const bool iWeightedByPCU = true ) const;

getTotalConnectionCostComponent

double      getTotalConnectionCostComponent( const GKCenConnection& iConnection, const GKFunctionComponent& iComponent, const bool iWeightedByPCU = true ) const;

getTotalRouteVolume

double      getTotalRouteVolume( const GKRoute& iRoute, const bool iWeightedByPCU = true ) const;

getTotalRouteCost

double      getTotalRouteCost( const GKRoute& iRoute, const bool iWeightedByPCU = true ) const;

getTotalRouteCostComponent

double      getTotalRouteCostComponent( const GKRoute& iRoute, const GKFunctionComponent& iComponent, const bool iWeightedByPCU = true ) const;

getTotalDetectorVolume

double      getTotalDetectorVolume( const GKDetector& iDetector, const bool iWeightedByPCU = true ) const;

MacroAdjustmentExperiment Class

The following functions have been added:

getTargetSlopeDev function

    double getTargetSlopeDev() const;

getTargetSlopeDev function

    void setTargetSlopeDev(double targetSlopeDev);

MacroAdjustmentOutput Class

The following functions have been removed: 

    const QVector<RegressionData> & getConvergenceData() const;
    GKCentroidConfiguration * getCentroidConfiguration( ) const;
    GKTimeDuration getDuration() const;
    QDateTime getStart() const;
    double getOriginalTrip( const GKCentroid& origin, const GKCentroid& destination, const GKUserClass& user ) const;
Now all data related to convergence via the MacroAdjustmentIterationLog.

MacroPTAdjustmentScenarioOutputData Class

The following function that was receiving a experiment ID receives now the experiment object: 

    QString getPathAssignmentResultsFileName( const GKGenericExperiment * experiment ) const;

PTResultAdjustmentState Class

This class has been added to help users access the original and adjusted demand, which groups the following data:

Origin Centroid

const GKCentroid *  origin:

Destination Centroid

const GKCentroid *  destination;

User Class

const GKUserClass * user;

Original Demand

double originalDemand

Adjusted Demand

double adjustedDemand

MacroPTAdjustmentResult Class

The way the original and adjusted demand values are accessed has changed.

The following function has been removed:

getStates

const QVector<MacroAdjustmentState*> & getStates() const;

And the following functions have been added to provide improved access to the same data:

getNumberOfStates

unsigned int    getNumberOfStates() const;

getState

const PTResultAdjustmentState &     getState( const unsigned int iIndex ) const;

findState

PTResultAdjustmentState     findState( const GKUserClass & iUserClass, const GKCentroid & iOrigin, const GKCentroid & iDestination ) const;

MacroPTExperimentParams Class

The following functions have been added:

walkingOnlyFunction

GKFunctionCost * walkingOnlyFunction() const;

setWalkingOnlyFunction

void setWalkingOnlyFunction( GKFunctionCost * aFunction );

GradientIterationValidationData Class

A new member variable has been added: 

    AdjustmentRegressionData measurements_regression;

Additionally, the member variable called "regression", has changed from: 

    AdjustmentRegressionData regression;
to 
    AdjustmentRegressionData demand_regression;
To specify which information contains.

OuterIterationValidationData Class

The "AssignmentData" class has been added to hold just the relevant data from a Static Assignment for this class. Because of this, a member variable "assign_data" has been added: 

    AssignmentData assignment_data;

Additionally, the member variable called "regression", has changed from: 

    AdjustmentRegressionData regression;
to 
    AdjustmentRegressionData measurement_regression;
To specify which information contains.

DistributionOutput Class

Several functions have been added to complete the scripting of this class and grant access to all the data it contains:

getNumberOfIndices

unsigned int    getNumberOfIndices() const;

createMatrix

GKODMatrix *    createMatrix( const unsigned int iIndex, const bool iTemporary ) const;

getTripPurpose

GKTripPurpose *     getTripPurpose( const unsigned int iIndex ) const;

getModes

std::vector< GKTransportationMode* >    getModes( const unsigned int iIndex ) const;

getCarAvailability

unsigned int    getCarAvailability( const unsigned int iIndex ) const;

getAverageImpedance

double          getAverageImpedance( const unsigned int iIndex )const;

getNumberOfIterations

unsigned int    getNumberOfIterations( const unsigned int iIndex ) const;

getEpsilon

double      getEpsilon( const unsigned int iIndex, const unsigned int iIteration ) const;

getResidual

double      getResidual( const unsigned int iIndex, const unsigned int iIteration ) const;

getRelativeGap

double      getRelativeGap( const unsigned int iIndex, const unsigned int iIteration ) const;

getError

double      getError( const unsigned int iIndex, const unsigned int iIteration ) const;

DistributionScenario Class

The following functions have been added to allow the edition of which vectors are added and which used in the DistributionScenario:

addVector

void addVector( const GKGenerationAttractionVector & iVector );

setUsedVector

void setUsedVector( const GKGenerationAttractionVector & iVector, const bool iUsed );

removeVector

void removeVector( const GKGenerationAttractionVector & iVector );

hasVector

bool hasVector( const GKGenerationAttractionVector & iVector ) const;

setUsedVector

void setUsedVector( const GKGenerationAttractionVector & iVector, const bool iUsed );

isUsed

bool isUsed( const GKGenerationAttractionVector & iVector ) const;

getVectors

QList<const GKGenerationAttractionVector*> getVectors() const;

NodeCompositor Class

The following method has been added in order to acces exclusively to the Four-Step Loops included in the compositor:

getLoops

std::vector<FourStepLoop*>      getLoops( ) const;

FourStepLoop Class

This class has been added and represents a Loop Controller Box and has all methods in NodeCompute plus the following ones available:

setLoopParams

void    setLoopParams( const FourStepLoopParams &loopParams );

getLoopParams

FourStepLoopParams      getLoopParams() const;

getLoopOutputs

const   FourStepLoopOutputs&    getLoopOutputs() const;

getNodesInLoop

QVector<NodeCompute *> getNodesInLoop() const;

FourStepLoopParams Class

This class has been added and represents the parameters which can be configured in the Loop Controller Box.

FourStepLoopOutputs Class

This class has been added and represents the outputs which can be generated from the Loop Controller Box.

Aimsun Next 22.0.1 changes

The following is a list of all the functions that have changed or have been added after the release of Aimsun Next 22.0.0 Final Release. The classes with changes are:

MacroDepartureAdjustmentOutput Class

createWarmupTrafficDemand

The following function has been added to generate just the warm-up demand: 

    GKTrafficDemand * createWarmupTrafficDemand() const;

GKFunctionCost Class

evaluateAdjustmentWeight

The signature of this function has been changed from: 

    double evaluateAdjustmentWeight(  double observed );
to: 
    double evaluateAdjustmentWeight( const GKFunctionCostContext* context, const double observed );

GKFunctionCostContext Class

  • The class GKFunctionCostContext now includes an iteration field which contains the static assignment iteration at which the function is being evaluated.

CMacroStatsManager Class

The following functions have been added to provide all the users and vehicles used in the stats:

getUsers function
    QVector< GKUserClass* >     getUsers() const;
getVehicles function
    QVector< GKVehicle* >       getVehicles() const;

The following functions have been added to give access to all the statistics of this class:

getSectionVolume function
    double          getSectionVolume( const GKUserClass * iUserClass, const GKSection& iSection) const;
getSectionVehicleVolume function
    double          getSectionVehicleVolume( const GKVehicle * iVehicle, const GKSection& iSection ) const;
getSectionOccupancy function
    double          getSectionOccupancy( const GKUserClass * iUserClass, const GKSection& iSection) const;
getSectionCost function
    double          getSectionCost( const GKUserClass * iUserClass, const GKSection& iSection) const;
getSectionCostComponent function
    double          getSectionCostComponent( const GKUserClass * iUserClass, const GKSection& iSection, const GKFunctionComponent& iComponent ) const;
getTurningVolume function
    double          getTurningVolume( const GKUserClass * iUserClass, const GKTurning& iTurning ) const;
getTurningVehicleVolume function
    double          getTurningVehicleVolume( const GKVehicle * iVehicle, const GKTurning& iTurning ) const;
getTurningPercentage function
    double          getTurningPercentage( const GKUserClass * iUserClass, const GKTurning& iTurning ) const;
getTurningCost function
    double          getTurningCost( const GKUserClass * iUserClass, const GKTurning& iTurning ) const;
getTurningCostComponent function
    double          getTurningCostComponent( const GKUserClass * iUserClass, const GKTurning& iTurning, const GKFunctionComponent& iComponent ) const;
getTrajectoryVolume function
    double          getTrajectoryVolume( const GKUserClass * iUserClass, const GKSuperNodeTrajectory& iTrajectory ) const;
getTrajectoryVehicleVolume function
    double          getTrajectoryVehicleVolume( const GKVehicle * iVehicle, const GKSuperNodeTrajectory& iTrajectory ) const;
getTrajectoryPercentage function
    double          getTrajectoryPercentage( const GKUserClass * iUserClass, const GKSuperNodeTrajectory& iTrajectory ) const;
getTrajectoryCost function
    double          getTrajectoryCost( const GKUserClass * iUserClass, const GKSuperNodeTrajectory& iTrajectory ) const;
getTrajectoryCostComponent function
    double          getTrajectoryCostComponent( const GKUserClass * iUserClass, const GKSuperNodeTrajectory& iTrajectory, const GKFunctionComponent& iComponent ) const;
getConnectionVolume function
    double          getConnectionVolume( const GKUserClass * iUserClass, const GKCenConnection& iConnection ) const;
getConnectionVehicleVolume function
    double          getConnectionVehicleVolume( const GKVehicle * iVehicle, const GKCenConnection& iConnection ) const;
getConnectionCost function
    double          getConnectionCost( const GKUserClass * iUserClass, const GKCenConnection& iConnection ) const;
getConnectionCostComponent function
    double          getConnectionCostComponent( const GKUserClass * iUserClass, const GKCenConnection& iConnection, const GKFunctionComponent& iComponent ) const;
getRouteVolume function
    double          getRouteVolume( const GKUserClass * iUserClass, const GKRoute& iRoute ) const;
getRouteVehicleVolume function
    double          getRouteVehicleVolume( const GKVehicle * iVehicle, const GKRoute& iRoute ) const;
getRouteCost function
    double          getRouteCost( const GKUserClass * iUserClass, const GKRoute& iRoute ) const;
getRouteCostComponent function
    double          getRouteCostComponent( const GKUserClass * iUserClass, const GKRoute& iRoute, const GKFunctionComponent& iComponent ) const;
getDetectorVolume function
    double          getDetectorVolume( const GKUserClass * iUserClass, const GKDetector& iDetector ) const;
getDetectorVehicleVolume function
    double          getDetectorVehicleVolume( const GKVehicle * iVehicle, const GKDetector& iDetector ) const;

MacroPTAdjustmentResult Class

The following functions have been added to give access to the demand adjusted via scripting:

getUsers function
    QVector<GKUserClass*>   getUsers() const;
publishAdjustedDemand function
    GKTrafficDemand *       publishAdjustedDemand( GKModel *iModel );
publishMatrix function
    GKODMatrix *            publishMatrix(GKUserClass * iUser , bool iCreateInModel) const;

MacroPTStatsView Class

The following methods have been added in order to obtain the statistics from Centroids and Centroid connections:

getCentroidAccess function
    double getCentroidAccess( const GKUserClass* iUserClass, const GKCentroid& iCentroid ) const;
getCentroidEgress function
double getCentroidEgress( const GKUserClass* iUserClass, const GKCentroid& iCentroid ) const;
getCentroidWalkOnlyAccess function
    double getCentroidWalkOnlyAccess( const GKUserClass* iUserClass, const GKCentroid& iCentroid ) const;
getCentroidWalkOnlyEgress function
    double getCentroidWalkOnlyEgress( const GKUserClass* iUserClass, const GKCentroid& iCentroid ) const;
getConnectionLoad function
    double getConnectionLoad( const GKUserClass* iUserClass, const GKCenConnection& iConnection ) const;
getConnectionAccess function
    double getConnectionAccess( const GKUserClass* iUserClass, const GKCenConnection& iConnection ) const;
getConnectionEgress function
    double getConnectionEgress( const GKUserClass* iUserClass, const GKCenConnection& iConnection ) const;
getConnectionWalkOnlyAccess function
    double getConnectionWalkOnlyAccess( const GKUserClass* iUserClass, const GKCenConnection& iConnection ) const;
getConnectionWalkOnlyEgress function
    double getConnectionWalkOnlyEgress( const GKUserClass* iUserClass, const GKCenConnection& iConnection ) const;

MacroPTPlugin Class

The following column ids have been added in order to collect the statistics of Walking-Only Access and Walking-Only Egress in GKColumns:

ePTWalkOnlyAccess
const QString ePTWalkOnlyAccess;
ePTWalkOnlyEgress
const QString ePTWalkOnlyEgress;

GKGenerationAttractionDataSet Class

The following function has been added to give access to the external data contained in the class:

getExternalData
QVector<ExternalData>       getExternalData( const GKCentroid* centroid ) const;

GKScriptNewCmd Class

Now it is possible to create different types of GKScript objects using the following function:

void setObjectType( GKScript::ScriptType type );
  • type param can be one of the following options, enum ScriptType{ eBasic, ePrePost, eFourStep }. If not specified the object will be created as GKScript::eBasic.

GKSection Class

The following function has been added to extract lane contour points:

getExtremePointsLane function
GKPoints getExtremePointsLane( uint lanepos ) const;

Aimsun Next 22 changes

The following is a list of all the functions that have changed between Aimsun Next 20 and Aimsun Next 22 in order to help update old scripts easily. The classes with changes are:

GKModel Class

setActiveExperimentId function

Function name changed: 

void setActiveExperimentId( quint32 id );
to 
void setActiveExperiment( GKGenericExperiment* experiment );

getActiveExperimentId function

Function name changed: 

quint32 getActiveExperimentId() const;
to 
GKGenericExperiment* getActiveExperiment() const;

setActiveReplicationId function

Function name changed: 

void setActiveReplicationId( quint32 id );
to 
void setActiveReplication( const GKReplication* replication );

getActiveReplicationId function

Function name changed: 

quint32 getActiveReplicationId() const;
to 
GKReplication* getActiveReplication() const;

ModalSplitScenario Class

setDataSet function

Function signature has changed from:

void setDataSet( quint32 id );
to 

void setDataSet( GKDistributionDataSet * dataSet );
getComponentSkim function

Function signature has changed from:

GKODMatrix* getComponentSkim( const GKODMatrix& iTripMatrix, const GKTransportationMode& iMode, const GKFunctionComponent& iComponent ) const;
to 

GKODMatrix* getComponentSkim( const GKODMatrix* iTripMatrix, const GKTransportationMode* iMode, const GKFunctionComponent* iComponent ) const;
setComponentSkim function

Function signature has changed from:

void setComponentSkim( const GKODMatrix& iTripMatrix, const GKTransportationMode& iMode, const GKFunctionComponent& iComponent, GKODMatrix& iSkim );
to 

void setComponentSkim( const GKODMatrix* iTripMatrix, const GKTransportationMode* iMode, const GKFunctionComponent* iComponent, GKODMatrix* iSkim );
removeComponentSkim function

Function signature has changed from:

void removeComponentSkim( const GKODMatrix& iTripMatrix, const GKTransportationMode& iMode, const GKFunctionComponent& iComponent );
to 

void removeComponentSkim( const GKODMatrix* iTripMatrix, const GKTransportationMode* iMode, const GKFunctionComponent* iComponent );
getUserDefinedSkim function

Function signature has changed from:

GKODMatrix* getUserDefinedSkim( const GKODMatrix& iTripMatrix, const GKTransportationMode& iMode, const uint iColumnIndex ) const;
to 

GKODMatrix* getUserDefinedSkim( const GKODMatrix* iTripMatrix, const GKTransportationMode* iMode, const uint iColumnIndex ) const;
setUserDefinedSkim function

Function signature has changed from:

void setUserDefinedSkim( const GKODMatrix& iTripMatrix, const GKTransportationMode& iMode, const uint iColumnIndex, GKODMatrix& iSkim );
to 

void setUserDefinedSkim( const GKODMatrix* iTripMatrix, const GKTransportationMode* iMode, const uint iColumnIndex, GKODMatrix* iSkim );
removeUserDefinedSkim function

Function signature has changed from:

void removeUserDefinedSkim( const GKODMatrix& iTripMatrix, const GKTransportationMode& iMode, const uint iColumnIndex );
to 

void removeUserDefinedSkim( const GKODMatrix* iTripMatrix, const GKTransportationMode* iMode, const uint iColumnIndex );
getAllSkims function

Function signature has changed from:

QVector<GKODMatrix*> getAllSkims( const GKODMatrix& iTripMatrix, const GKTransportationMode& iMode ) const;
to 

QVector<GKODMatrix*> getAllSkims( const GKODMatrix* iTripMatrix, const GKTransportationMode* iMode ) const;

ModalSplitOutput Class

getTripPurposes function

Function signature has changed from:

QVector< GKTripPurpose* > getTripPurposes( GKModel * model ) const;
to 
QVector< GKTripPurpose* > getTripPurposes() const;

getVehicles function

Function signature has changed from:

QVector<const GKMobileAgent*> getVehicles( GKModel * model ) const;
to 
QVector<const GKMobileAgent*> getVehicles() const;

getUsers function

Function signature has changed from:

QVector< GKUserClass * > getUsers( GKModel * model ) const;
to 
QVector< GKUserClass * > getUsers() const;

getModalSplit function

Function signature has changed from:

double getModalSplit( GKModel * model, GKTripPurpose * purpose, const GKMobileAgent * vehicle ) const;
to 
double getModalSplit( GKTripPurpose * purpose, const GKMobileAgent * vehicle ) const;

getTimePeriod function

Function signature has changed from:

GKTimePeriod * getTimePeriod( GKModel * model ) const;
to 
GKTimePeriod * getTimePeriod() const;

ModalSplitTripMatricesUtil Class

tripMatrices function

Function signature has changed from:

QList<quint32> tripMatrices() const;
to 

QList<const GKODMatrix*> tripMatrices() const;
usedTripMatrices function

Function signature has changed from:

const QSet<quint32> & usedTripMatrices() const;
to 

QList<const GKODMatrix*> usedTripMatrices() const;
tripMatrixData function

Function signature has changed from:

GKLandUseModesUtil tripMatrixData( quint32 iTripMatrix ) const;
to 

GKLandUseModesUtil tripMatrixData( const GKODMatrix* matrix ) const;
setUsedTripMatrices function

Function signature has changed from:

void setUsedTripMatrices( const QSet<quint32> &iUsedTripMatrices );
to 

void setUsedTripMatrices( const QVector<GKODMatrix*> &iUsedTripMatrices );
modes function

Functions:

QList<quint32> modes() const;
QList<quint32> modes( quint32 iTripMatrix ) const;
are replaced by

QList<GKTransportationMode*> modes() const;

DistributionScenario Class

getSkim function

Function signature has changed from:

GKODMatrix* getSkim( const GKGenerationAttractionVector& iGAVector , const GKTransportationMode& iMode ,  const GKODMatrix::AssignmentOutput & iCostType ) const;
to 

GKODMatrix* getSkim( const GKGenerationAttractionVector* iGAVector , const GKTransportationMode* iMode ,  const SkimType& type ) const;
setSkim function

Function signature has changed from:

void setSkim(const GKGenerationAttractionVector& iGAVector , const GKTransportationMode& iMode , GKODMatrix &iSkim );
to 
void setSkim(const GKGenerationAttractionVector* iGAVector , const GKTransportationMode* iMode , GKODMatrix *iSkim );

removeSkim function

Function signature has changed from:

void removeSkim( const GKGenerationAttractionVector& iGAVector , const GKTransportationMode& iMode ,  const GKODMatrix::AssignmentOutput & iCostType );
to 
void removeSkim( const GKGenerationAttractionVector* iGAVector , const GKTransportationMode* iMode ,  const SkimType& type  );

getComponentSkim function

Function signature has changed from:

GKODMatrix* getComponentSkim( const GKGenerationAttractionVector& iGAVector , const GKTransportationMode& iMode, const GKFunctionComponent& iComponent ) const;
to 
GKODMatrix* getComponentSkim( const GKGenerationAttractionVector* iGAVector , const GKTransportationMode* iMode, const GKFunctionComponent* iComponent ) const;

setComponentSkim function

Function signature has changed from:

void setComponentSkim( const GKGenerationAttractionVector& iGAVector , const GKTransportationMode& iMode, const GKFunctionComponent& iComponent, GKODMatrix& iSkim );
to 
void setComponentSkim( const GKGenerationAttractionVector* iGAVector , const GKTransportationMode* iMode, const GKFunctionComponent* iComponent, GKODMatrix* iSkim );

removeComponentSkim function

Function signature has changed from:

void removeComponentSkim( const GKGenerationAttractionVector& iGAVector , const GKTransportationMode& iMode, const GKFunctionComponent& iComponent );
to 
void removeComponentSkim( const GKGenerationAttractionVector* iGAVector , const GKTransportationMode* iMode, const GKFunctionComponent* iComponent );

getUserDefinedSkim function

Function signature has changed from:

GKODMatrix* getUserDefinedSkim( const GKGenerationAttractionVector& iGAVector , const GKTransportationMode& iMode, const uint iColumnIndex ) const;
to 
GKODMatrix* getUserDefinedSkim( const GKGenerationAttractionVector* iGAVector , const GKTransportationMode* iMode, const uint iColumnIndex ) const;

setUserDefinedSkim function

Function signature has changed from:

void setUserDefinedSkim( const GKGenerationAttractionVector& iGAVector , const GKTransportationMode& iMode, const uint iColumnIndex, GKODMatrix& iSkim );
to 
void setUserDefinedSkim( const GKGenerationAttractionVector* iGAVector , const GKTransportationMode* iMode, const uint iColumnIndex, GKODMatrix* iSkim );

removeUserDefinedSkim function

Function signature has changed from:

void removeUserDefinedSkim( const GKGenerationAttractionVector& iGAVector , const GKTransportationMode& iMode, const uint iColumnIndex );
to 
void removeUserDefinedSkim( const GKGenerationAttractionVector* iGAVector , const GKTransportationMode* iMode, const uint iColumnIndex );

getAllSkims function

Function signature has changed from:

QVector<GKODMatrix*> getAllSkims( const GKGenerationAttractionVector& iGAVector , const GKTransportationMode& iMode ) const;s
to 
QVector<GKODMatrix*> getAllSkims( const GKGenerationAttractionVector* iGAVector , const GKTransportationMode* iMode ) const;

GravityModelParams Class

setDeterrenceFunctionId function

Function changed from:

void setDeterrenceFunctionId(qint32 iDeterrenceFunctionId);
to 

void setDeterrenceFunction( GKFunctionCost* iDeterrenceFunction );
getDeterrenceFunctionId function

Function changed from:

qint32  getDeterrenceFunctionId() const;
to 

GKFunctionCost*  getDeterrenceFunction() const;

GKLandUseModesUtil Class

setObject function

Function signature has changed from:

void setObject( quint32 iObject );
to 
void setObject( const GKObject* iObject );

object function

Function signature has changed from:

quint32 object() const;
to 
const GKObject* object() const;

addMode function

Function signature has changed from:

void addMode( quint32 iMode );
to 
void addMode( const GKTransportationMode* iMode );

contains function

Function signature has changed from:

bool contains( quint32 iMode ) const;
to 
bool contains( const GKTransportationMode* iMode ) const;

modes function

Function signature has changed from:

QList<quint32> modes() const;
to 
QVector<GKLandUseSkimMatricesUtil> modes() const;

addMacroComponent function

Function signature has changed from:

void addMacroComponent( quint32 iMacroComponentId );
to 
void addMacroComponent( const GKFunctionComponent* component );

skims function

Function signature has changed from:

GKLandUseSkimMatricesUtil skims( quint32 iMode ) const;
to 
GKLandUseSkimMatricesUtil skims( const GKTransportationMode * iMode ) const;

GKLandUseSkimMatricesUtil Class

transportationMode function

Function signature has changed from:

quint32 transportationMode() const;
to 
const GKTransportationMode* transportationMode() const;

setCostSkim function

Function signature has changed from:

void setCostSkim( const quint32 &iSkim );
to 
void setCostSkim( const GKODMatrix *iSkim );

costSkim function

Function signature has changed from:

const quint32 & costSkim() const;
GKODMatrix * costSkim( GKModel *iModel ) const;
to 
GKODMatrix * costSkim() const;

setDistanceSkim function

Function signature has changed from:

void setDistanceSkim( const quint32 &iSkim );
to 
void setDistanceSkim( const GKODMatrix *iSkim );

distanceSkim function

Functions:

const quint32 & distanceSkim() const;
GKODMatrix * distanceSkim( GKModel *iModel ) const;
are replaced by 
GKODMatrix * distanceSkim() const;

setTravelTimeSkim function

Function signature has changed from:

void setTravelTimeSkim( const quint32 &iSkim );
to 
void setTravelTimeSkim( const GKODMatrix *iSkim );

travelTimeSkim function

Functions:

const quint32 & travelTimeSkim() const;
GKODMatrix * travelTimeSkim( GKModel *iModel ) const;
are replaced by 
GKODMatrix * travelTimeSkim() const;

travelTimeSkim function

Functions:

const quint32 & travelTimeSkim() const;
GKODMatrix * travelTimeSkim( GKModel *iModel ) const;
are replaced by 
GKODMatrix * travelTimeSkim() const;

setInVehicleTimeSkim function

Function signature has changed from:

void setInVehicleTimeSkim( const quint32 &iSkim );
to 
void setInVehicleTimeSkim( const GKODMatrix *iSkim );

inVehicleTimeSkim function

Functions:

const quint32 & inVehicleTimeSkim() const;
GKODMatrix * inVehicleTimeSkim( GKModel *iModel ) const;
are replaced by 
GKODMatrix * inVehicleTimeSkim() const;

setWaitingTimeSkim function

Function signature has changed from:

void setWaitingTimeSkim( const quint32 &iSkim );
to 
void setWaitingTimeSkim( const GKODMatrix *iSkim );

waitingTimeSkim function

Functions:

const quint32 & waitingTimeSkim() const;
GKODMatrix * waitingTimeSkim( GKModel *iModel ) const;
are replaced by 
GKODMatrix * waitingTimeSkim() const;

setWalkingTimeSkim function

Function signature has changed from:

void setWalkingTimeSkim( const quint32 &iSkim );
to 
void setWalkingTimeSkim( const GKODMatrix *iSkim );

walkingTimeSkim function

Functions:

const quint32 & walkingTimeSkim() const;
GKODMatrix * walkingTimeSkim( GKModel *iModel ) const;
are replaced by 
GKODMatrix * walkingTimeSkim() const;

setTransferPenaltySkim function

Function signature has changed from:

void setTransferPenaltySkim( const quint32 &iSkim );
to 
void setTransferPenaltySkim( const GKODMatrix *iSkim );

transferPenaltySkim function

Functions:

const quint32 & transferPenaltySkim() const;
GKODMatrix * transferPenaltySkim( GKModel *iModel ) const;
are replaced by 
GKODMatrix * transferPenaltySkim() const;

setFareSkim function

Function signature has changed from:

void setFareSkim( const quint32 &iSkim );
to 
void setFareSkim( const GKODMatrix *iSkim );

fareSkim function

Functions:

const quint32 & fareSkim() const;
GKODMatrix * fareSkim( GKModel *iModel ) const;
are replaced by 
GKODMatrix * fareSkim() const;

setCrowdDiscomfortSkim function

Function signature has changed from:

void setCrowdDiscomfortSkim( const quint32 &iSkim );
to 
void setCrowdDiscomfortSkim( const GKODMatrix *iSkim );

crowdDiscomfortSkim function

Functions 

const quint32 & crowdDiscomfortSkim() const;
GKODMatrix * crowdDiscomfortSkim( GKModel *iModel ) const;
are replaced by 
GKODMatrix * crowdDiscomfortSkim() const;

addMacroComponent function

Function signature has changed from:

void addMacroComponent( quint32 iMacroComponentId );
to 
void addMacroComponent( const GKFunctionComponent* component );

setMacroComponentSkim function

Function signature has changed from:

void setMacroComponentSkim( quint32 iMacroComponentId, quint32 iSkim );
to 
void setMacroComponentSkim( const GKFunctionComponent* component, const GKODMatrix* iSkim );

macroComponentSkim function

Function signature has changed from:

quint32 macroComponentSkim( quint32 iMacroComponentId ) const;
to 
GKODMatrix* macroComponentSkim( const GKFunctionComponent* component ) const;

setUserDefinedSkim function

Function signature has changed from:

void setUserDefinedSkim( int index, quint32 iSkim );
to 
void setUserDefinedSkim( int index, const GKODMatrix* iSkim );

userDefinedSkims function

Function signature has changed from:

const QList<quint32> & userDefinedSkims() const;
to 
QList<const GKODMatrix*> userDefinedSkims() const;

SkimDataProvider Class

The enum type SkimType has been moved outside of this class into the generic namespace. Now it is defined in the GKLandUseSkimMatricesUtil.

MacroPTExperimentParams Class

Functions 

qint32 transferPenaltyId() const;
void setTransferPenalty( qint32 iId );

are replaced by

GKFunctionCost* getTransferPenalty() const;
void setTransferPenalty( GKFunctionCost* function );

MacroPTAdjustmentScenarioOutputData Class

userDefinedSkims function

Function signature has changed from:

GKProblemNet * getProblemNet(GKModel *iModel) const;
to 
GKProblemNet * getProblemNet() const;

PTExperimentOutputData Class

getSkimMatrices function

Function signature has changed from:

QVector< qint32 > getSkimMatrices( GKModel * model ) const;
to 
QList< const GKODMatrix* > getSkimMatrices() const;

setSkimMatrices function

Function signature has changed from:

void setSkimMatrices( const QVector<qint32> & iMatrices );
to 
void setSkimMatrices( const QVector<const GKODMatrix*>& matrices );

GKDistributionDataSet Class

setDistributionArea function

Function signature has changed from:

void setDistributionArea( int iCentroidId, int iArea );
to 
void setDistributionArea( const GKCentroid* centroid, GKDistributionCentroidType* area );

setParkingArea function

Function signature has changed from:

void setParkingArea( int iCentroidId, int iArea );
to 
void setParkingArea( const GKCentroid* centroid, GKParkingCentroidType* area );

setAttributeValue function

Function signature has changed from:

void setAttributeValue(qint32 iCentroidId, int iUserClassId, int attributeIndex, double iValue );
to 
void setAttributeValue( const GKCentroid* centroid, GKUserClass *user, int attributeIndex, double iValue );

getAttributeValue function

Function signature has changed from:

double getAttributeValue(qint32 iCentroidId, int iUserClassId, int attributeIndex ) const;
to 
double getAttributeValue( const GKCentroid* centroid, GKUserClass *user, int attributeIndex ) const;

getDistributionData function

Function signature has changed from:

CentroidDistributionData* getDistributionData( int iCentroidId ) const;
to 
CentroidDistributionData* getDistributionData( const GKCentroid* centroid ) const;

setDistributionData function

Function signature has changed from:

void setDistributionData( int iCentroidId, CentroidDistributionData * iCentroidDistributionData );
to 
void setDistributionData( const GKCentroid* centroid, CentroidDistributionData * iCentroidDistributionData );

getDistributionArea function

Function signature has changed from:

GKDistributionCentroidType * getDistributionArea( int iCentroidId ) const;
to 
GKDistributionCentroidType * getDistributionArea( const GKCentroid* centroid ) const;

getParkingArea function

Function signature has changed from:

GKParkingCentroidType * getParkingArea( int iCentroidId ) const;
to 
GKParkingCentroidType * getParkingArea( const GKCentroid* centroid ) const;

setUseParkingAreaCosts function

Function signature has changed from:

void setUseParkingAreaCosts( int iCentroidId, bool iValue );
to 
void setUseParkingAreaCosts( const GKCentroid* centroid, bool iValue );

getUseParkingAreaCosts function

Function signature has changed from:

bool getUseParkingAreaCosts( int iCentroidId ) const;
to 
bool getUseParkingAreaCosts( const GKCentroid* centroid ) const;

setExternalArea function

Function signature has changed from:

void setExternalArea( int iCentroidId, bool iValue );
to 
void setExternalArea( const GKCentroid* centroid, bool iValue );

getExternalArea function

Function signature has changed from:

bool getExternalArea( int iCentroidId ) const;
to 
bool getExternalArea( const GKCentroid* centroid ) const;

getModalSplitData function

New function to access the modal split data of a centroid. Total set of records: 

void QVector<ModalSplitData> getModalSplitData( const GKCentroid* centroid ) const;
Specific record: 
ModalSplitData getModalSplitData(ModalSplitData::Type iType, const GKCentroid* centroid, qint32 iPurpose, qint32 iCarAvailability, qint32 iTimePeriod ) const;

setModalSplitData function

New function to set the total set of records of modal split in a centroid: 

void setModalSplitData( const GKCentroid* centroid, const QVector< ModalSplitData > & iData );

ModalSplitData Class

getCarAvailabiltiy function

New function to get the car availability: 

qint32 getCarAvailabiltiy() const;

getFactor function

New function to get a transportation mode factor: 

double getFactor( GKTransportationMode* mode ) const;

getPurpose function

New function to get the purpose: 

qint32 getPurpose() const;

getTimePeriod function

New function to get the time period: 

qint32 getTimePeriod() const;

getType function

New function to get the modal split type ( 0 - Generation, 1 - Attraction ): 

Type getType() const;

setCarAvailability function

New function to set the car availability: 

void setCarAvailability( qint32 iMode );

setFraction function

New function to set factor of a transportation mode: 

void setFraction( GKTransportationMode* iMode, double iFactor );

setPurpose function

New function to set the purpose: 

void setPurpose( GKTripPurpose* purpose );

setTimePeriod function

New function to set the time period: 

void setTimePeriod( GKTimePeriod* period );

setType function

New function to set the modal split type ( 0 - Generation, 1 - Attraction ): 

void setType( Type iType );

valid function

New function to check modal split data validity ( valid = attributes and percentages are correct ): 

bool valid() const;

validAttributes function

New function to check modal split data attributes validity: 

bool validAttributes() const;

validPercentages function

New function to check modal split data percentages validity: 

bool validPercentages() const;

CentroidDistributionData Class

distributionArea attribute

Attribute int distributionArea has been replaced by the following functions: 

    void setDistributionArea( GKDistributionCentroidType* area );
    GKDistributionCentroidType* getDistributionArea() const;

parkingArea attribute

Attribute int parkingArea has been replaced by the following functions: 

    void setParkingArea( GKParkingCentroidType * area );
    GKParkingCentroidType* getParkingArea() const;

setDistributionAttribute function

Function signature has changed from:

void setDistributionAttribute( int iUserClassId, uint iIndex, double iValue );
to 
void setDistributionAttribute( GKUserClass *user, uint iIndex, double iValue );

getDistributionAttribute function

Function signature has changed from:

double getDistributionAttribute( int iUserClassId, uint iIndex ) const
to 
double getDistributionAttribute( GKUserClass *user, uint iIndex ) const;

MacroExperimentOutputData Class

getSkimMatrices function

Function signature has changed from:

QVector< GKODMatrix* > getSkimMatrices( GKModel * model ) const;
to 
QVector< GKODMatrix* > getSkimMatrices() const;

setSkimMatrices function

Function signature has changed from:

void setSkimMatrices( const QVector<qint32> & iMatrices );
to 
void setSkimMatrices( const QVector<GKODMatrix*> & iMatrices );

GKGenerationAttractionScenario Class

setDataGroup function

Function signature has changed from:

void setDataGroup( int dataGroup );
to 
void setDataGroup( GKGenerationAttractionDataSet* dataGroup );

getDataGroup function

Function signature has changed from:

int getDataGroup() const;
to 
GKGenerationAttractionDataSet* getDataGroup() const;

GKGenerationAttractionCentroidType Class

setGAFactors function

Function signature has changed from: 

void setGAFactors( qint32 dataSetId, qint32 variableId, qint32 timePeriodId, qint32 modeId, qint32 purposeId, double generation, double attraction );
to 
void setGAFactors( GKGenerationAttractionDataSet* dataSet, qint32 variableId, qint32 timePeriodId, qint32 modeId, qint32 purposeId, double generation, double attraction );

getGAFactors function

Function signature has changed from: 

QPair<double,double> getGAFactors( qint32 dataSetId, qint32 variableId, qint32 timePeriodId, qint32 modeId, qint32 purposeId );
to 
QPair<double,double> getGAFactors( GKGenerationAttractionDataSet* dataSet, qint32 variableId, qint32 timePeriodId, qint32 modeId, qint32 purposeId ) const;

GKGenerationAttractionData Class

m_variable attribute

Attribute int m_variable has been replaced by the following functions: 

    void setVariable( GKGenerationAttractionDataSetAttribute* var );
    GKGenerationAttractionDataSetAttribute* getVariable() const;

m_timePeriod attribute

Attribute int m_timePeriod has been replaced by the following functions: 

    void setTimePeriod( GKTimePeriod* period );
    GKTimePeriod* getTimePeriod() const;

m_mode attribute

Attribute int m_mode has been replaced by the following functions: 

    void setMode( GKTransportationMode* mode );
    GKTransportationMode* getMode() const;

GKGenerationAttractionFactor Class

m_purpose attribute

Attribute int m_purpose has been replaced by the following functions: 

    void setPurpose( GKTripPurpose* purpose );
    GKTripPurpose* getPurpose() const;

GKGenerationAttractionDataSet Class

getTripGenerationArea function

Function signature has changed from:

GKGenerationAttractionCentroidType * getTripGenerationArea( int iCentroidId ) const;
to 
GKGenerationAttractionCentroidType * getTripGenerationArea( const GKCentroid* centroid ) const;

setTripGenerationArea function

Function signature has changed from:

void setTripGenerationArea( int iCentroidId, int iAreaId );
to 
void setTripGenerationArea( const GKCentroid* centroid, GKGenerationAttractionCentroidType* area );

useExternalData function

Function signature has changed from:

bool useExternalData( int iCentroidId ) const;
to 
bool useExternalData( const GKCentroid* centroid ) const;

setExternalData function

Function signature has changed from:

void setExternalData( int iCentroidId, QVector<ExternalData> & iExternalData );
to 
void setExternalData( const GKCentroid* centroid, QVector<ExternalData> & iExternalData );

setUseExternalData function

Function signature has changed from:

void setUseExternalData( int iCentroidId, bool iExternalData );
to 
void setUseExternalData( const GKCentroid* centroid, bool iExternalData );

setCarAvailabilityData function

Function signature has changed from:

void    setCarAvailabilityData( int iCentroidId, QVector<CAData> & iCAData );
to 
void    setCarAvailabilityData( const GKCentroid* centroid, QVector<CAData> & iCAData );


void    setCarAvailabilityData( int iCentroidId, int purposeId, double iValue );
to 
void    setCarAvailabilityData( const GKCentroid* centroid, int purposeId, double iValue );

getCarAvailabilityData function

Function signature has changed from:

double  getCarAvailabilityData( int iCentroidId, int purposeId );
to 
double  getCarAvailabilityData( const GKCentroid* centroid, int purposeId );

setAttributeData function

Function signature has changed from:

void setAttributeData( int iCentroidId, qint32 iAttributeId, double iValue );
to 
void setAttributeData( const GKCentroid* centroid, GKGenerationAttractionDataSetAttribute* attr, double iValue );

setCarOwnership function

Function signature has changed from:

void setCarOwnership( int iCentroidId, int iCarOwnership );
to 
void setCarOwnership( const GKCentroid* centroid, int iCarOwnership );

setAverageHousehold function

Function signature has changed from:

void setAverageHousehold( int iCentroidId, double iAverageHousehold );
to 
void setAverageHousehold( const GKCentroid* centroid, double iAverageHousehold );

doBalancing function

Function signature has changed from:

bool    doBalancing( int iCentroidId ) const;
to 
bool    doBalancing( const GKCentroid* centroid ) const;

setDoBalancing function

Function signature has changed from:

void    setDoBalancing( int iCentroidId, bool iBalancing );
to 
void    setDoBalancing( const GKCentroid* centroid, bool iBalancing );

getCarOwnership function

Function signature has changed from:

int     getCarOwnership( int iCentroidId ) const;
to 
int     getCarOwnership( const GKCentroid* centroid ) const;

getAverageHousehold function

Function signature has changed from:

double  getAverageHousehold( int iCentroidId ) const;
to 
double  getAverageHousehold( const GKCentroid* centroid ) const;

addAttribute function

Function signature has changed from:

void addAttribute(int iAttributeId);
to 
void addAttribute( GKGenerationAttractionDataSetAttribute* iAttribute );

getAttributes function

Function signature has changed from:

const QVector<int> & getAttributes();
to 
QVector<GKGenerationAttractionDataSetAttribute*> getAttributes();

checkCreateData function

Function signature has changed from:

void checkCreateData( int iCentroidId );
to 
void checkCreateData( const GKCentroid* centroid );

getData function

Function signature has changed from:

const CentroidGenerationAttractionData * getData( int iCentroid ) const;
to 
const CentroidGenerationAttractionData * getData( const GKCentroid* centroid ) const;

getValue function

Function signature has changed from:

double getValue( int iCentroid, int iAttributeId ) const;
to 
double getValue( const GKCentroid* centroid, GKGenerationAttractionDataSetAttribute* iAttribute ) const;

setValue function

Function signature has changed from:

void setValue( int iCentroid, int iAttributeId, double iValue );
to 
void setValue( const GKCentroid* centroid, GKGenerationAttractionDataSetAttribute* iAttribute, double iValue );

setExternalData function

Function signature has changed from:

void setExternalData( int iCentroidId, int purpose, int mode, int period, double arrivals, double departures );
to 
void setExternalData( const GKCentroid* centroid, int purpose, int mode, int period, double arrivals, double departures );

getExternalData function

Function signature has changed from:

QPair<double,double> getExternalData( int iCentroidId, int purpose, int mode, int period, bool found ) const;
to 
QPair<double,double> getExternalData( const GKCentroid* centroid, int purpose, int mode, int period, bool found ) const;

CentroidGenerationAttractionData Class

attributes attribute

Access to attributes is now done via the following functions: 

    void setValue( GKGenerationAttractionDataSetAttribute* attr, double value );
    double getValue( GKGenerationAttractionDataSetAttribute* attr ) const;

tripGenerationArea attribute

Access to tripGenerationArea is now done via the following functions: 

    void setArea( GKGenerationAttractionCentroidType* area );
    GKGenerationAttractionCentroidType* getArea() const;

GKDistributionCentroidType Class

getDistributionFunction function

Function signature has changed from:

int getDistributionFunction( int iDataSet, int iPurpose, int iCA, int iTimePeriod );
to 
GKFunctionCost* getDistributionFunction( const GKDistributionDataSet* dataset, const GKTripPurpose* purpose, qint32 iCA, const GKTimePeriod* timePeriod ) const;

setDistributionFunction function

Function signature has changed from:

void setDistributionFunction( int iDataSet, int iPurpose, int iCA, int iTimePeriod, int iFunctionId );
to 
void setDistributionFunction( const GKDistributionDataSet* dataset, const GKTripPurpose* purpose, qint32 iCA, const GKTimePeriod* timePeriod, const GKFunctionCost* function );

getModalSplitFunction function

Function signature has changed from:

int getModalSplitFunction( int iDataSet, int iPurpose, int iCA, int iTimePeriod );
to 
GKFunctionCost* getModalSplitFunction( const GKDistributionDataSet* dataset, const GKTripPurpose* purpose, qint32 iCA, const GKTimePeriod* timePeriod ) const;

setModalSplitFunction function

Function signature has changed from:

void setModalSplitFunction( int iDataSet, int iPurpose, int iCA, int iTimePeriod, int iFunctionId );
to 
void setModalSplitFunction( const GKDistributionDataSet* dataset, const GKTripPurpose* purpose, qint32 iCA, const GKTimePeriod* timePeriod, const GKFunctionCost* function );

GKControlPlan Class

addControlMetering function

Function signature has changed from:

void addControlMetering( uint idmetering, GKControlMetering *meter );
to 
void addControlMetering( GKMetering *metering, GKControlMetering *meter );

removeControlMetering function

Function signature has changed from:

void removeControlMetering( uint idmetering );
to 
void removeControlMetering( GKMetering *metering );

removeControlMetering function

Function signature has changed from:

GKControlMetering * getControlMetering( uint /*idmetering*/ ) const;
to 
GKControlMetering * getControlMetering( GKMetering* metering ) const;

removeControlMetering function

Function signature has changed from:

const GKControlPlanJunctions & getControlJunctions() const;
to 
QMap<uint, GKControlJunction*> getControlJunctions() const;

removeControlMetering function

Function signature has changed from:

const GKControlPlanMeterings & getControlMeterings() const;
to 
QMap<uint, GKControlMetering*> getControlMeterings() const;

GKControlPhase Class

addSignal function

Function signature has changed from:

void addSignal( uint idSignal, const QString & name = "", GKControlPhaseSignal::FlashingType flashing = GKControlPhaseSignal::eNo );
to 
void addSignal( GKControlPlanSignal* signal, GKControlPhaseSignal::FlashingType flashing = GKControlPhaseSignal::eNo );

GKControlPhaseSignal Class

GKControlPhaseSignal function

Function signature has changed from:

GKControlPhaseSignal( uint, const QString &, FlashingType );
to 
GKControlPhaseSignal( GKControlPlanSignal* s, FlashingType f );

Public attributes to functions

Public attributes no longer available:

    uint signal;
    QString name;
    FlashingType flashing;

The following functions need to be used instead:

    void setSignal( GKControlPhaseSignal* signal );
    GKControlPhaseSignal* getSignal() const;

    void setFlashingType( GKControlPhaseSignal::FlashingType flashing );
    GKControlPhaseSignal::FlashingType getFlashingType() const;

NodeOutput Class

The following functions have been renamed to ease the comprehension of the NodeOutput class:

getOutputs function

Function signature has changed from:

const QVector< NodeOutputElement > &        getOutputs() const;
to: 
const QVector< NodeOutputElement > &        getElements() const;

setOutputs function

Function signature has changed from:

void    setOutputs( const QVector< NodeOutputElement > & elements );
to: 
void    setElements( const QVector< NodeOutputElement > & elements );

NodeSlot Class

The following functions have been renamed to ease the comprehension of the NodeSlot class:

getObjectType function

Function signature has changed from: 

EDataObjectType     getObjectType() const;
to: 
EDataObjectType     getSlotType() const;

NodeConnection Class

The following functions have been renamed to ease the comprehension of the NodeConnection class:

getFilter function

Function signature has changed from:

const NodeOutput &      getFilter() const;
to: 
const NodeOutput &      getDiscardedElements() const;

setFilter function

Function signature has changed from:

void        setFilter( const NodeOutput & filter );
to: 
void        setDiscardedElements( const NodeOutput & iElements );

Yutraffic Classes

A generalization of Yutraffic plugin has been implemented and therefore the following classes have been renamed:

  • SitrafficDetectionPatternTemplateNewCmd to OCITDetectionPatternTemplateNewCmd
  • SitrafficDetectionPatternNewCmd to OCITDetectionPatternNewCmd
  • SitrafficDetectionPatternTemplate to OCITDetectionPatternTemplate
  • SitrafficDetectionPattern to OCITDetectionPattern
  • SitrafficDetectionPatternEvent to OCITDetectionPatternEvent
  • SitrafficSimulationEvent to OCITSimulationEvent
OCITDetectionPatternEvent Class

The start and duration of a SitrafficDetectionPatternEvent was stablished using the following functions: 

    void setWhen( int cycle, double secondInCycle );
    void setDuration( const GKTimeDuration & time );

This is no longer the case for OCITDetectionPatternEvent, the correct way to set an activation time is to use the function: 

    void setFrom( int cycle, double secondInCycle );

To deactivate de event the following use function: 

    void setTo( int cycle, double secondInCycle );

Calling either void setWhen( int cycle, double secondInCycle ); or void setDuration( const GKTimeDuration & time ); will result in undefined behavior.

Aimsun Next 20.0.X changes

The following is a list of all the functions that have changed or have been added after the release of Aimsun Next 20. The classes with changes are:

GKFunctionComponent Class

The GKFunctionComponent class has been opened to scripting via the following functions:

setDerived
void    setDerived( bool iValue );
getDerived
bool    getDerived() const;
setFunctionString
void    setFunctionString( QString iValue );
getFunctionString
const QString & getFunctionString() const;
setComponent1
void    setComponent1( qint32 iValue );
getComponent1
qint32  getComponent1() const;
setComponent2
void    setComponent2( qint32 iValue );
getComponent2
qint32  getComponent2() const;
setFactor
void    setFactor( double iValue );
getFactor
double  getFactor() const;
setOperation
void    setOperation( Operation operation );
getOperation
Operation   getOperation() const;

Where Operation can represent the following operations: 

enum Operation{eMultiply=0, eDivide, eAdd, eSubtract}

DistributionScenario Class

The following functions have been added to allow the selection of the skim matrices associated to GKFunctionComponents via scripting:

getComponentSkim
GKODMatrix* getComponentSkim( const GKGenerationAttractionVector& iGAVector , const GKTransportationMode& iMode, const GKFunctionComponent& iComponent ) const;
setComponentSkim
void setComponentSkim( const GKGenerationAttractionVector& iGAVector , const GKTransportationMode& iMode, const GKFunctionComponent& iComponent, GKODMatrix& iSkim );
removeComponentSkim
void removeComponentSkim( const GKGenerationAttractionVector& iGAVector , const GKTransportationMode& iMode, const GKFunctionComponent& iComponent );

ModalSplitScenario Class

The following functions have been added to allow the selection of the trip matrices and to ease the selection of of the skims matrices associated to them:

removeTripMatrices
void removeTripMatrices();
addTripMatrix
void addTripMatrix( GKODMatrix& iMatrix );
getSkim
GKODMatrix* getSkim( const GKODMatrix& iTripMatrix, const GKTransportationMode& iMode ,  const GKODMatrix::AssignmentOutput & iCostType ) const;
setSkim
void    setSkim( const GKODMatrix& iTripMatrix, const GKTransportationMode& iMode , GKODMatrix &iSkim );
removeSkim
void    removeSkim( const GKODMatrix& iTripMatrix, const GKTransportationMode& iMode ,  const GKODMatrix::AssignmentOutput & iCostType );
getComponentSkim
GKODMatrix* getComponentSkim( const GKODMatrix& iTripMatrix, const GKTransportationMode& iMode, const GKFunctionComponent& iComponent ) const;
setComponentSkim
void    setComponentSkim( const GKODMatrix& iTripMatrix, const GKTransportationMode& iMode, const GKFunctionComponent& iComponent, GKODMatrix& iSkim );
removeComponentSkim
void    removeComponentSkim( const GKODMatrix& iTripMatrix, const GKTransportationMode& iMode, const GKFunctionComponent& iComponent );
getUserDefinedSkim
GKODMatrix* getUserDefinedSkim( const GKODMatrix& iTripMatrix, const GKTransportationMode& iMode, const uint iColumnIndex ) const;
setUserDefinedSkim
void    setUserDefinedSkim( const GKODMatrix& iTripMatrix, const GKTransportationMode& iMode, const uint iColumnIndex, GKODMatrix& iSkim );
removeUserDefinedSkim
void    removeUserDefinedSkim( const GKODMatrix& iTripMatrix, const GKTransportationMode& iMode, const uint iColumnIndex );
getAllSkims
QVector<GKODMatrix*>    getAllSkims( const GKODMatrix& iTripMatrix, const GKTransportationMode& iMode ) const;

The following functions has been added to select the GKTimePeriod:

setTimePeriod
void    setTimePeriod( GKTimePeriod* iTimePeriod );

We recommend to use it instead of:

setTimePeriod
void    setTimePeriod( quint32 timePeriod );

MacroScenarioOutputData Class

The following functions have been added to configure the scenario to collect (or not) SubPath statistics:

getCollectSubPathsStats
bool getCollectSubPathsStats() const;
setCollectSubPathsStats
bool setCollectSubPathsStats( bool iValue );

CMacroTurning Class

The following function has been added to access the duration of the uncontrolled time for the period under study (e.g. simulation duration):

double  getUncontrolledTime() const;

DTATurning Class

The following function has been added to access the duration of the uncontrolled time for the period under study (e.g. Route Choice Interval):

double  getUncontrolledTime() const;

DistributionOutput Class

createMatrix

The function: 

QVector< GKODMatrix * > createMatrix( GKTripPurpose* iPurpose, bool temporary )

Now only accepts well-defined GKTripPurposes (different than None): 

QVector< GKODMatrix * > createMatrix( const GKTripPurpose& iPurpose, bool temporary )

MacroAdjustmentScenarioParams Class

The following function has been added in order to give access to the Congested Sections group:

getCongestedSections
GKGroup * getCongestedSections() const;

MacroPTStatsManager Class

The following functions have been added in order to allow (when combined with a MacroPTStatsView) to access the outputs from a Static Transit Assignment (MacroPTExperiment)

getExperiment
MacroPTExperiment *  getExperiment() const;
getFromTime
QDateTime   getFromTime() const;
getToTime
QDateTime   getFromTime() const;
restore
void   restore( MacroPTExperiment * _experiment );

MacroPTStatsView Class

A new helper class to help collecting statistics has been added. The Macro Transit Stats View class gives access to all statistics calculated by a Static Transit Assignment (MacroPTExperiment). There are 52 methods which are not listed here to improve readability.

GKFunctionCost Class

The following functions have been added to the GKFunctionCost class in order to improve the consistency of the scripting when evaluating the Transit Delay Time:

evaluatePTDelayTime

double evaluatePTDelayTime(const GKFunctionCostContext * context, const GKPublicLine& iLine, const GKPTSectionData&iSection ) const;

evaluatePTDelayTime

double evaluatePTDelayTime(const GKFunctionCostContext * context, const GKPublicLine& iLine, const StopToStop& iSection) const;

evaluatePTDelayTime

double evaluatePTDelayTime(const GKFunctionCostContext * context, const GKSimulatedObject& iLine, const void* iSection) const;

As the previous functions contain explicit information of the argument types, should be preferred over the function:

evaluatePTDelayTime

double evaluatePTDelayTime(const GKFunctionCostContext * context, const GKBaseObject * iLine, const void *iSection , const bool fromGui, const bool iFromDTA ) const;

GKPTStation Class

The set/get functions for the connection waiting times have been updated in the GKPTStation class in order to improve its readability and consistency:

The function:

setWaitingTimes

void setWaitingTimes(const QMap< QPair<GKPublicLine*,GKPublicLine*>, double> & waitingTimes);

has been replaced by the function:

setWaitingTime

void setWaitingTime( const GKPublicLine& iFromLine, const GKPublicLine& iToLine, const double iWaitingTime );

The function:

getWaitingTimes

const QMap< QPair<GKPublicLine*,GKPublicLine*>, double> & getWaitingTimes() const;

has been replaced by the function:

getWaitingTime

double & getWaitingTimes(const GKPublicLine& iFromLine, const GKPublicLine& iToLine) const;

DTAPTLineSegment Class

The access to the origin and destination stop has been made consistent with the context they refer to. The following functions have been removed:

getDTAOrigin

const DTAPTStop * getDTAOrigin() const;

getDTADestination

const DTAPTStop * getDTADestination() const;

While the following functions have been modified:

getOrigin

const GKBusStop* getOrigin() const;

has been replaced by the function:

getOrigin

const DTAPTStop* getOrigin() const;

And the function:

getDestination

const GKBusStop* getDestination() const;

has been replaced by the function:

getDestination

const DTAPTStop* getDestination() const;

If the user requires accessing the GKBusStop associated to a DTAPTStop, just use the function GKSimulatedObject::getMaster() on DTAPTStop.

PTSection Class

The access to the origin and destination stop has been made consistent with the context they refer to. The following functions have been removed:

getOriginPT

const PTStop * getOriginPT() const;

getDestinationPT

const PTStop * getDestinationPT() const;

While the following functions have been modified:

getOrigin

const GKBusStop* getOrigin() const;

has been replaced by the function:

getOrigin

const PTStop* getOrigin() const;

And the function:

getDestination

const GKBusStop* getDestination() const;

has been replaced by the function:

getDestination

const PTStop* getDestination() const;

If the user requires accessing to the GKBusStop associated to a PTStop, just use the function GKSimulatedObject::getMaster() on PTStop.

GKModel Class

The default identifier form is now stored at GKModel level. The following functions have been added:

setIdentifierForm

void setIdentifierForm( GKObject::IdentifierForm form );

getIdentifierForm

GKObject::IdentifierForm getIdentifierForm() const;

GKObject Class

The default identifier form is now handled at GKModel level. GKObject::defaultIdentifierForm is no longer available.

GenerationAttractionOutput Class

The following functions have been added to access to the total arrivals and departures filtering by GKTripPurpose, GKTransportationMode and whether if the value is before or after balancing departures and arrivals ( by default after balancing ):

getTotalArrivals

double  getTotalArrivals( const GKTripPurpose& iPurpose , const GKTransportationMode& iMode, bool iBeforeBalance = false  )     const;

getTotalArrivalsCA

double  getTotalArrivalsCA( const GKTripPurpose& iPurpose , const GKTransportationMode& iMode, bool iBeforeBalance = false )    const;

getTotalArrivalsNCA

double  getTotalArrivalsNCA( const GKTripPurpose& iPurpose , const GKTransportationMode& iMode, bool iBeforeBalance = false )   const;

getTotalDepartures

double  getTotalDepartures( const GKTripPurpose& iPurpose , const GKTransportationMode& iMode,  bool iBeforeBalance = false )   const;

getTotalDeparturesCA

double  getTotalDeparturesCA( const GKTripPurpose& iPurpose , const GKTransportationMode& iMode, bool iBeforeBalance = false )  const;

getTotalDeparturesNCA

double  getTotalDeparturesNCA( const GKTripPurpose& iPurpose , const GKTransportationMode& iMode, bool iBeforeBalance = false ) const;

NodeOutputElement Class

The following functions have been added to complete the scripting of this class:

getOutputType

double  getOutputType() const;

setOutputType

double  setOutputType( const EDataObjectType iOutputType ) const;

setDiscriminant

QVector<FourSteps::DataDiscriminant>    getDiscriminants() const;

FourStepsUtil File

This file has been added to centralize all definitions that are common to all classes and methods define in the FourSteps plug-in scripting. Such as FourSteps::DataDiscriminant or the EDataObjectType.

NodeSlot Class

The following functions have been added to complete the scripting of this class:

getObjectType function
EDataObjectType getObjectType() const;
getConnectionType function
EConnectionType getConnectionType() const;
getMode function
ESlotMode getMode() const;
isCompatible function
bool isCompatible( const NodeSlot * iNodeSlot ) const;
getConnections function
QVector< NodeConnection * > getConnections() const;
getOutputElements function
NodeOutput      getOutputElements() const;

NodeCompute Class

The following functions have been added to complete the scripting of this class:

getInputSlots function
QVector< NodeSlot * >       getInputSlots() const;
getOutputSlots function
QVector< NodeSlot * >       getOutputSlots() const;
getTarget function
GKObject*                   getTarget();
getSlotOutputElements function
QVector<NodeOutputElement>  getSlotOutputElements( const QString &slotId ) const;
getOutputObjects function
QVector<GKObject*> getOutputObjects( const QString & slotId ) const;

NodeConnection Class

The following functions have been added to complete the scripting of this class:

getFilter function
const NodeOutput &  getFilter() const;
setFilter function
void                setFilter( const NodeOutput & filter );

GKControllerParsSitrafficOffice Class

The following functions have been added to complete the scripting of this class:

setProtocolFilepath function
    void setProtocolFilepath( const QString& filepath );
getProtocolFilepath function
    const QString& getProtocolFilepath() const;
setGraphicalViewConfigurations function
    void setGraphicalViewConfigurations( const QStringList& configurations );
getGraphicalViewConfigurations function
    const QStringList& getGraphicalViewConfigurations() const;
setProtocolViewConfigurations function
    void setProtocolViewConfigurations( const QStringList& configurations );
getProtocolViewConfigurations function
    const QStringList& getProtocolViewConfigurations() const;

Aimsun Next 20 changes

The following is a list of all the functions that have changed between Aimsun Next 8.4 and Aimsun Next 20 in order to help update old scripts easily. The classes with changes are:

GKCatalog Class

findObjectsByExternalId function

The function now returns all objects with the same external id for a given GKType instead of just one.

GKGeometryConfiguration Class

existent function

Function signature has changed from:

bool existent(quint32 val);

to

bool existent( const GKObject* object);
nonexistent function

Function signature has changed from:

bool nonexistent(quint32 val);

to:

bool nonexistent( const GKObject* object);
getExistent function

Function signature has changed from:

const QSet<quint32> & getExistent() const;

to:

QVector<GKObject*> getExistent() const;
getNonExistent function

Function signature has changed from:

const QSet<quint32> & getNonExistent() const;

to:

QVector<GKObject*> getNonExistent() const;
addExistent function

Function signatures has changed from:

void addExistent( quint32 id );

to:

void addExistent( GKObject* object );
addNonExistent function

Function signatures has changed from:

void addNonExistent( quint32 id );

to:

void addNonExistent( GKObject* object );
removeExistent function

Function signatures has changed from:

void removeExistent( quint32 id );

to:

void removeExistent( GKObject* object );
removeNonExistent function

Function signatures has changed from:

void removeNonExistent( quint32 id );

to:

void removeNonExistent( GKObject* object );

GKProblemNet Class

getManualSections function

Function signature has changed from:

const QVector<uint> & getManualSections() const;

to

QVector<GKSection*> getManualSections() const;
setManualSections function

Function signature has changed from:

void setManualSections( QVector<uint> sections );

to

void setManualSections( const QVector<GKSection*>& sections );
addManualSection function

Function signature has changed from:

void addManualSection( uint aId );

to

void addManualSection( GKSection* section );
removeManualSection function

Function signature has changed from:

void removeManualSection( uint aId );

to

void removeManualSection( GKSection* section );
containsManualSection function

Function signature has changed from:

bool containsManualSection( uint aId ) const;

to

bool containsManualSection( GKSection* section ) const;

GKSimulationArea Class

getManualSections function

Function signature has changed from:

const QVector<quint32> & getManualSections() const;

to

QVector<GKSection*> getManualSections() const;
setManualSections function

Function signature has changed from:

void setManualSections( QVector<quint32> sections );

to

void setManualSections( const QVector<GKSection*>& sections );
addManualSection function

Function signature has changed from:

void addManualSection( quint32 aId );

to

void addManualSection( GKSection* section );
removeManualSection function

Function signature has changed from:

void removeManualSection( quint32 aId );

to

void removeManualSection( GKSection* section );
containsManualSection function

Function signature has changed from:

bool containsManualSection( quint32 aId ) const;

to

bool containsManualSection( GKSection* section ) const;

GKTrafficArrivals Class

setReplication function

Function signature has changed from:

void setReplication( uint id );

to

void setReplication( GKReplication* replication );
getReplication function

Function signature has changed from:

uint getReplication() const;

to

const GKReplication* getReplication() const;

AdjustmentMeasurementContext Class

The MeasurementType type now can represent one more types of measurement: eTotalODCount (associated to the OD term aggregated by time interval):

enum MeasurementType{ eNone, eSection, eTurning, eDetector, eOriginCount, eDestinationCount, eBoarding, eAlighting, ePathLengthDistribution, ePTDetector, eODProportions, eSuperNodeTrajectory, eGKRoute, eTotalODCount, eODCount }

MacroAdjustmentScenario Class

The following functions have been moved to MacroAdjustmentExperiment:

getParams Function
    const MacroAdjustmentScenarioParams & getParams() const;
setParams Function
    void setParams( const MacroAdjustmentScenarioParams & params );
setTripMatrix Function
    void setTripMatrix( GKODMatrix *iMatrix );
tripMatrix Function
    GKODMatrix* tripMatrix() const;
setTripMatrixReliability Function
    void setTripMatrixReliability( double iFactor );
tripMatrixReliability Function
    double tripMatrixReliability() const;
setTripMatrixCentroidGrouping Function
    void setTripMatrixCentroidGrouping( GKGroup *iGroup );
tripMatrixCentroidGrouping Function
    GKGroup* tripMatrixCentroidGrouping() const;

The following functions have been added:

getInitialDateTime Function
    QDateTime getInitialDateTime() const;
getDuration Function
    GKTimeDuration getDuration() const;
getFinishDateTime Function
    QDateTime getFinishDateTime() const;
storeOutput Function
    bool storeOutput() const;
setStoreOutput Function
    void setStoreOutput( bool iValue );

MacroAdjustmentExperiment Class

The following functions have been added:

getParams Function
    const MacroAdjustmentScenarioParams & getParams() const;
setParams Function
    void setParams( const MacroAdjustmentScenarioParams & params );
setTripMatrix Function
    void setTripMatrix( GKODMatrix *iMatrix );
tripMatrix Function
    GKODMatrix* tripMatrix() const;
setTripMatrixReliability Function
    void setTripMatrixReliability( double iFactor );
tripMatrixReliability Function
    double tripMatrixReliability() const;
setTripMatrixCentroidGrouping Function
    void setTripMatrixCentroidGrouping( GKGroup *iGroup );
tripMatrixCentroidGrouping Function
    GKGroup* tripMatrixCentroidGrouping() const;
setDefaultParamsForAllUserClasses Function
    void setDefaultParamsForAllUserClasses( float alpha, float tripLengthDistributionElasticity );

MacroAdjustmentScenarioUserClassParams Class

getPerCentroidEntranceData Function

Function signature has been changed from: 

    GKCentroidVector * getPerCentroidEntranceData( GKModel * iModel ) const;

to 

    GKCentroidVector * getPerCentroidEntranceData() const;
getPerCentroidExitData Function

Function signature has been changed from: 

    GKCentroidVector * getPerCentroidExitData(GKModel *iModel) const;

to 

    GKCentroidVector * getPerCentroidExitData() const;
getODMaxDeviations Function

Function signature has been changed from: 

    GKODMatrix * getODMaxDeviations( GKModel * iModel ) const;

to 

    GKODMatrix * getODMaxDeviations() const;

MacroAdjustmentScenarioParams Class

The following functions have been moved to MacroAdjustmentScenario:

getInitialDateTime Function
    QDateTime getInitialDateTime() const;
getDuration Function
    GKTimeDuration getDuration() const;
storeOutput Function
    bool storeOutput() const;
setStoreOutput Function
    void setStoreOutput( bool iValue );

The following function has been moved to MacroAdjustmentExperiment:

setDefaultParamsForAllUserClasses Function
    void setDefaultParamsForAllUserClasses( double alpha, double tripLengthDistributionElasticity);

The following functions have been changed:

setDetectorGrouping Function

Function signature has been changed from: 

    void setDetectorGrouping( qint32 iGrouping );

to 

    void setDetectorGrouping(  GKGroupingType* grouping  );
setCentroidGrouping Function

Function signature has been changed from: 

    void setCentroidGrouping( qint32 iGrouping );

to 

    void setCentroidGrouping( GKGroupingType* grouping  );
getDetectorGrouping Function

Function signature has been changed from: 

    qint32 getDetectorGrouping() const;

to 

    GKGroupingType* getDetectorGrouping() const;
getCentroidGrouping Function

Function signature has been changed from: 

    qint32 getCentroidGrouping() const;

to

    GKGroupingType* getCentroidGrouping() const;

The following function has been removed:

setDetectorCoverageThreshold Function
    void setDetectorCoverageThreshold( int value );

MacroPTAdjustmentScenario Class

The following functions have been moved to MacroPTAdjustmentExperiment:

getMatrixDeviations Function
    QMap< GKUserClass*, GKODMatrix* > getMatrixDeviations() const;
setMatrixDeviations Function
    void setMatrixDeviations( const QMap< GKUserClass*, GKODMatrix * > & iMatrixDeviations );
getDeviationType Function
    MatrixDeviation::MatrixDeviationValueType getDeviationType() const;
setDeviationType Function
    void setDeviationType( MatrixDeviation::MatrixDeviationValueType iType );

MacroPTAdjustmentExperiment Class

The following functions have been added:

getMatrixDeviations Function
    QMap< GKUserClass*, GKODMatrix* > getMatrixDeviations() const;
setMatrixDeviations Function
    void setMatrixDeviations( const QMap< GKUserClass*, GKODMatrix * > & iMatrixDeviations );
getDeviationType Function
    MatrixDeviation::MatrixDeviationValueType getDeviationType() const;
setDeviationType Function
    void setDeviationType( MatrixDeviation::MatrixDeviationValueType iType );

DistributionScenario Class

The following functions have been added:

getSkim Function

        GKODMatrix* getSkim( const GKGenerationAttractionVector& iGAVector , const GKTransportationMode& iMode ,  const GKODMatrix::AssignmentOutput & iCostType ) const;

setSkimFunction

        void setSkim(const GKGenerationAttractionVector& iGAVector , const GKTransportationMode& iMode , GKODMatrix &iSkim ) const;

removeSkim Function

        void removeSkim( const GKGenerationAttractionVector& iGAVector , const GKTransportationMode& iMode ,  const GKODMatrix::AssignmentOutput & iCostType );

getUserDefinedSkim Function

        GKODMatrix* getUserDefinedSkim( const GKGenerationAttractionVector& iGAVector , const GKTransportationMode& iMode, const uint iColumnIndex ) const;

setUserDefinedSkim Function

        void setUserDefinedSkim( const GKGenerationAttractionVector& iGAVector , const GKTransportationMode& iMode, const uint iColumnIndex, GKODMatrix& iSkim );

removeUserDefinedSkim Function

        void removeUserDefinedSkim( const GKGenerationAttractionVector& iGAVector , const GKTransportationMode& iMode, const uint iColumnIndex );

getAllSkims Function

        QVector<GKODMatrix*> getAllSkims( const GKGenerationAttractionVector& iGAVector , const GKTransportationMode& iMode ) const;

We recommend to use them for setting the Skims Matrices instead of:

setInitialUserSkim Function

        void setInitialUserSkim( const QMap<GKUserClass*, GKODMatrix *> & iSkims );

getInitialUserSkims Function

        QMap<GKUserClass*, GKODMatrix*> getInitialUserSkims() const;

getInitialUserSkim Function

        getInitialUserSkim( GKUserClass * iUser ) const;

Aimsun Next 8.4 changes

The following is a list of all the functions that have changed between Aimsun Next 8.3 and Aimsun Next 8.4 in order to help update old scripts easily. The classes with changes are:

GKScenarioInputData Class

getRecordSimulation function

The function to set or get whether a dynamic simulation is being recorded has been moved from the GKScenarioInputData class to the GKReplication class. The signature of both functions has remained the same and it is:

bool getRecordSimulation() const;

void setRecordSimulation( bool aRecordSimulation );

AdjustmentMeasurementContext Class

The MeasurementType type now can represent two more types of measurement: eGKRoute (associated to subpath counts) and eODCount (associated to the OD term):

enum MeasurementType{ eNone, eSection, eTurning, eDetector, eOriginCount, eDestinationCount, eBoarding, eAlighting, ePathLengthDistribution, ePTDetector, eODProportions, eSuperNodeTrajectory, eGKRoute, eODCount }

Changes introduced before Aimsun Next 8.4

The following is a list of all the functions that have changed between versions prior to Aimsun Next 8.4 in order to help update old scripts easily. The classes with changes are:

Besides that, there were changes in functions used for simulating and to create commands.

GKFolder Class

Aimsun 8.1.1 changes

getContentsTypes function

The getContentsTypes functions now has a fourth parameter to include the travel demand model.

Old signature:

QVector<GKType*> getContentsTypes( bool staticOn = true, bool mesoOn = true, bool microOn = true ) const;

New signature:

QVector<GKType*> getContentsTypes( bool staticOn = true, bool mesoOn = true, bool microOn = true, bool travelDemand = true ) const;

GKPublicLine Class

Aimsun 8.1.1 changes

createPTSections function

The createPTSections functions available in Aimsun 8.0 are no longer available in Aimsun 8.1 as GKPTSection has been removed.

Instead of calling the non-available function:

void createPTSections( const QList<GKSection*> & route, const QVector<GKBusStop*> & stops );

the following functions can be used:

publicLine.unsetPTLineForSections()
publicLine.setRoute( route )
publicLine.setPTLineForSections()
publicLine.setStops( stops )

GKNode Class

Aimsun 8.1.2 changes

getSignalPos function

The signature of getSignalPos has changed from:

uint getSignalPos( uint idSignal ) const;

to:

uint getSignalPos( uint idSignal, uint scenarioId = 0 ) const;

to include geometry configurations.

    /*! Returns the resulting vector of calculating the vectorial product between this vector and v2 */
    GKVector prodVect( const GKVector & v2 ) const; //producto vectorial entre this y v2.
    /*! Returns the scalar product between to vectors*/
    double prodEsc( const GKVector & v2) const;

GKVector

Aimsun 8.1.1 changes

prodVect Function

The function prodVect with signature:

    GKVector prodVect( const GKVector & v2 ) const;

has been replaced by the function:

    GKVector crossProduct( const GKVector & v2 ) const;
prodEsc Function

The function prodEsc with signature:

    double prodEsc( const GKVector & v2) const;

has been replaced by the function:

    double dotProduct( const GKVector & v2) const;

QString

Aimsun 8.2 changes

QString object has been deprecated. The new version automatically transforms QString objects into Python Strings and, therefore, their usage can be exactly as a Python String. In example:

    eid = section.getExternalId().toInt()

should be replaced by

    eid = int( section.getExternalId() )

QTime

Aimsun 8.2 changes

QTime usage has changed. The default constructor QTime() returns an invalid QTime object. Therefore, any method applied on it will fail. In order to create a QTime properly, the hours and minutes must be provided.

    qtime = QTime(0,0)

GKSection

GKSection getLanesLength function

The function:

GKCoord getLanesLength() const;

was deprecated in Aimsun Next 8.3 and it should be changed to either getLanesLength2D() or getLanesLength3D() depending on the output expected.

The main change in Aimsun 8.3 was the deprecation of all the different scripting classes to do the calculation procedures (dynamic simulations, assignment, adjustment, outputs retrieval, etc.).

Those classes and functions have been substituted by a mechanism, called Kernel Actions, for the different calculation procedures (dynamic simulations, assignment, adjustment, etc.) to provide a common interface to command their execution.

GKSystem has a method, GKSystem::executeAction, that allows you to execute a Kernel Action for a target object or a selection of objects.

All objects that perform a calculation (replication, assignment experiment, adjustment experiment, etc.) implement a Kernel Action, called execute, that starts the calculation. This has the same effect as right clicking on the object and selecting the menu item that starts the calculation (run batch simulation, run static traffic assignment, run static OD adjustment, etc.).

This makes particularly easy performing tasks like, for example, starting a batch simulation of a replication:

replication = model.getCatalog().find( 1001 )
GKSystem.getSystem().executeAction( "execute", replication, [], "" )

To run a set of simulations in sequence, you just have to provide a list of replications as third argument. Note that you need to state one of the replications as the second argument even though only the ones in the list (third argument), if it is not empty, will be simulated. The second argument needs to be an object of the same type as the ones in the third argument.

replication1 = model.getCatalog().find( 1001 )
replication2 = model.getCatalog().find( 1002 )
GKSystem.getSystem().executeAction( "execute", replication1, [replication1, replication2], "" )

To run a microscopic simulation in animated mode you just have to replace the action execute with the action play.

It’s worth noting that Kernel Actions are accessible also from the command line (DOS prompt or Terminal); therefore, you don’t need to write a script if you want to run programmatically a simulation that is already set.

"Aimsun Next" --verbose --project test.ang --command execute --target 1001

Commands to create all types of scenarios and experiments are now available.

Furthermore, the doit and undoit functions are no longer available and the model.getCommander().addCommand function should be used instead. For example, to create a Macro Transit Adjustment Experiment, the following code could be used:

cmd = model.createNewCmd( model.getType( "MacroPTAdjustmentExperiment" ));
cmd.setScenario( scenario );
model.getCommander().addCommand( cmd );
res = cmd.createdObject();