TorqueConverter.h

Go to the documentation of this file.

/*
Copyright 2007-2025. Algoryx Simulation AB.
 
All AGX source code, intellectual property, documentation, sample code,
tutorials, scene files and technical white papers, are copyrighted, proprietary
and confidential material of Algoryx Simulation AB. You may not download, read,
store, distribute, publish, copy or otherwise disseminate, use or expose this
material unless having a written signed agreement with Algoryx Simulation AB, or having been
advised so by Algoryx Simulation AB for a time limited evaluation, or having purchased a
valid commercial license from Algoryx Simulation AB.
 
Algoryx Simulation AB disclaims all responsibilities for loss or damage caused
from using this software, unless otherwise stated in written agreements with
Algoryx Simulation AB.
*/
 
#pragma once
 
#include <agxModel/export.h>
#include <agxPowerLine/PowerLine.h>
#include <agxDriveTrain/Gear.h>
 
namespace agxDriveTrain
{
  class AGXMODEL_EXPORT TorqueConverter : public agxDriveTrain::Gear
  {
  public:
    TorqueConverter();
 
    agx::Real getPumpTorque();
 
    agx::Real getTurbineTorque();
 
    agx::Real getOilDensity() const;
 
    bool setOilDensity(agx::Real oilDensity);
 
    agx::Real getPumpDiameter() const;
 
    bool setPumpDiameter(agx::Real pumpDiameter);
 
    void setEfficiencyTable(const agx::RealPairVector& velRatio_efficiency);
 
    void setGeometryFactorTable(const agx::RealPairVector& velRatio_geometryFactor);
 
    void clearEfficiencyTable();
 
    void clearGeometryFactorTable();
 
    void insertEfficiencyLookupValue(agx::Real velocityRatio, agx::Real efficiency);
 
    void insertGeometryFactorLookupValue(agx::Real velocityRatio, agx::Real geometryFactor);
 
    const agxPowerLine::LinearLookupTable* getEfficiencyTable() const;
 
    const agxPowerLine::LinearLookupTable* getGeometryFactorTable() const;
 
    void enableLockUp(bool enable);
 
    bool getEnableLockUp() const;
 
    void setLockUpTime(agx::Real time);
 
    agx::Real getLockUpTime() const;
 
    DOXYGEN_START_INTERNAL_BLOCK()
    virtual void initConstraint() override;
    virtual bool preUpdate(agx::Real timeStep) override;
    virtual bool store(agxStream::StorageStream& str) const override;
    virtual bool restore(agxStream::StorageStream& str) override;
    AGXSTREAM_DECLARE_SERIALIZABLE(agxDriveTrain::TorqueConverter);
    DOXYGEN_END_INTERNAL_BLOCK()
 
  protected:
    virtual ~TorqueConverter();
    agxPowerLine::LinearLookupTableRef m_efficiencyTable;
    agxPowerLine::LinearLookupTableRef m_geometryFactorTable;
 
    agx::Real m_oilDensity;
    agx::Real m_diameter;
    agx::Real m_m0;
    agx::Real m_pumpTorque;
    agx::Real m_turbineTorque;
 
    bool m_lockEnabled;
    agx::Real m_lockTime;
    agx::Real m_timeSinceLock;
    agx::Real m_ratioAtLock;
 
  private:
    void calculateInternalTorques(agx::Real inputVel, agx::Real outputVel);
    void controlLock(agx::Real timeStep);
 
  };
  AGX_DECLARE_POINTER_TYPES(TorqueConverter);
}