Skip to main content

OpenTD .NET4 reference 2025 R2

OpenTD.Results.Dataset.DerivedDataset Class Reference

Last update: 16.07.2025

A dataset derived from one or more input datasets. When you request data from a DerivedDataset, it performs an operation on the input datasets to combine their data. For example, a ConcatenatedDataset stitches together all of the data from its input datasets. More...

Inheritance diagram for OpenTD.Results.Dataset.DerivedDataset:
OpenTD.Results.Dataset.RecordFocusedDatasetOpenTD.Results.Dataset.IDatasetOpenTD.Results.Dataset.DatasetOpenTD.Results.Dataset.IDatasetOpenTD.Results.Dataset.IAutoNameOpenTD.Results.Dataset.IDatasetOpenTD.Results.Dataset.IAutoNameOpenTD.Results.Dataset.IAutoCommentOpenTD.Results.Dataset.IAutoNameOpenTD.Results.Dataset.IAutoNameOpenTD.Results.Dataset.ConcatenatedDatasetOpenTD.Results.Dataset.DatasetSlice

Public Member Functions

 DerivedDataset ()
 
override List< string > GetThermalSubmodels ()
 Gets all unique thermal submodel names from InputDatasets.
 
override List< string > GetFluidSubmodels ()
 Gets all unique fluid submodel names from InputDatasets.
 
override List< string > GetRegisterNames ()
 Gets all unique register names from InputDatasets.
 
override List< long > GetNodeIds (string submodel)
 Gets all unique node numbers from InputDatasets for a given submodel.
 
override List< long > GetLumpIds (string submodel)
 Gets all unique lump numbers from InputDatasets for a given submodel.
 
override List< long > GetPathIds (string submodel)
 Gets all unique path numbers from InputDatasets for a given submodel.
 
override List< long > GetTieIds (string submodel)
 Gets all unique tie numbers from InputDatasets for a given submodel.
 
override List< long > GetFtieIds (string submodel)
 Gets all unique FTie numbers from InputDatasets for a given submodel.
 
override List< long > GetIfaceIds (string submodel)
 Gets all unique IFace numbers from InputDatasets for a given submodel.
 
override List< long > GetConductorIds (string submodel)
 Gets all unique conductor numbers from InputDatasets for a given submodel.
 
override void Close ()
 
override void ReOpen ()
 
override DataArrayCollection GetData (DataItemIdentifierCollection dataItems)
 
virtual DataArrayCollection GetData (params string[] sindaNames)
 
virtual DataArrayCollection GetData (ItemIdentifierCollection itemIds, DataSubtype subtype, UnitsData units=null)
 
override List< List< string > > GetUdcaData (DataItemIdentifierCollection dataItems)
 
override DataArray GetRegisterData (string registerName, DataSubtype subtype=null, UnitsData units=null)
 
DataArray GetDataAtRecord (DataSubtype subtype, long recordNum)
 Gets all data for a given subtype at a single record. If recordNum is invalid, or if no data of the given subtype exists at the record, will return an empty DataArray.
 
DataArray GetRegisterDataAtRecord (long recordNum, DataSubtype subtype=null, UnitsData units=null)
 Gets all register data at a single record. Use GetRegisterNames to get a list of register names in the same order as the data returned from this method. Or use GetInternalIndex to find the index of a specific register in this list. If recordNum is invalid, or if no register data exists at the record, will return an empty DataArray.
 
List< DataSubtype > GetUdfasAtRecord (long recordNum)
 Gets DataSubtypes UDFA at the given record number.
 
List< string > GetUdcaDataAtRecord (DataSubtype subtype, long recordNum)
 Gets the UDFA of strings represented by a DataSubtype at a given record.
 
DataArray GetConstraintData (long constraintNumber, DataSubtype subtype=null, UnitsData units=null)
 
DataArray GetReliabilityData (long reliabilityNumber, DataSubtype subtype=null, UnitsData units=null)
 
List< long > GetRecordNumbers ()
 
DataArray GetRecordNumbersAsDataArray ()
 
List< string > GetRecordNames ()
 
DataArray GetTimes ()
 
DataArray GetTimesOrRecordNumbers ()
 
long GetNsol (long recordNum)
 
long GetNpcsrec (long recordNum)
 
Dimensional< StefanBoltzmann > GetSigma ()
 
Dimensional< Temp > GetAbszro ()
 
Dimensional< Pressure > GetPatmos ()
 
List< long > GetLoopctData ()
 
List< long > GetLoopcoData ()
 
long GetNamedInt (IntegerNames name)
 
long GetNamedInt (string name)
 
List< long > GetNamedIntArray (ArrayIntegerNames name)
 
List< long > GetNamedIntArray (string name)
 
long GetInternalIndex (DataTypes dataType, string submodel, long id)
 The 0-indexed position of the given Sinda entity in arrays returned by GetDataAtRecord. Returns -1 if entity can't be found.
 
virtual long GetInternalIndex (string registerName)
 The 0-indexed position of the given register in arrays returned by GetRegisterDataAtRecord. Returns -1 if registerName can't be found.
 
override string ToString ()
 

Protected Member Functions

virtual void CheckInputDatasets ()
 
bool UnitsChangedSinceLastRead ()
 
virtual string GetSelfSuggestedName ()
 
virtual string GetSelfSuggestedComment ()
 
List< T_item > Relay< T_collection, T_item > (T_collection x)
 
List< T_item > Relay< T_item > (List< T_item > x)
 

Properties

List< IDataset > InputDatasets [get, set]
 The list of Datasets this derives its data from.
 
override string Source [get, protected set]
 If the InputDatasets have a common source, it will be returned here.
 
UnitsData Units [get, set]
 The unit system of the dataset.
 
IUDFAManager UDFAManager = null [get, set]
 
AutoNamer AutoNamer [get, set]
 
string Name [get, set]
 
string InternalSuggestedName [get, set]
 
AutoCommenter AutoCommenter [get, set]
 
string Comment [get, set]
 
string InternalSuggestedComment [get, set]
 

Detailed Description

A dataset derived from one or more input datasets. When you request data from a DerivedDataset, it performs an operation on the input datasets to combine their data. For example, a ConcatenatedDataset stitches together all of the data from its input datasets.

See also
OpenTD.Results.Dataset.Dataset, OpenTD.Results.Dataset.ConcatenatedDataset

Constructor & Destructor Documentation

◆ DerivedDataset()

OpenTD.Results.Dataset.DerivedDataset.DerivedDataset ( )
inline

Member Function Documentation

◆ CheckInputDatasets()

virtual void OpenTD.Results.Dataset.DerivedDataset.CheckInputDatasets ( )
inlineprotectedvirtual

◆ Close()

override void OpenTD.Results.Dataset.DerivedDataset.Close ( )
inline

◆ GetAbszro()

Dimensional< Temp > OpenTD.Results.Dataset.Dataset.GetAbszro ( )
abstractinherited

◆ GetConductorIds()

override List< long > OpenTD.Results.Dataset.DerivedDataset.GetConductorIds ( string submodel)
inline

Gets all unique conductor numbers from InputDatasets for a given submodel.

Parameters
submodelThe submodel name.
Returns
List<System.Int64>.

Implements OpenTD.Results.Dataset.IDataset.

◆ GetConstraintData()

DataArray OpenTD.Results.Dataset.Dataset.GetConstraintData ( long constraintNumber,
DataSubtype subtype = null,
UnitsData units = null )
abstractinherited

◆ GetData() [1/3]

virtual DataArrayCollection OpenTD.Results.Dataset.Dataset.GetData ( ItemIdentifierCollection itemIds,
DataSubtype subtype,
UnitsData units = null )
inlinevirtualinherited

◆ GetData() [2/3]

virtual DataArrayCollection OpenTD.Results.Dataset.Dataset.GetData ( params string[] sindaNames)
inlinevirtualinherited

◆ GetData() [3/3]

override DataArrayCollection OpenTD.Results.Dataset.RecordFocusedDataset.GetData ( DataItemIdentifierCollection dataItems)
inlineinherited

◆ GetDataAtRecord()

DataArray OpenTD.Results.Dataset.Dataset.GetDataAtRecord ( DataSubtype subtype,
long recordNum )
abstractinherited

Gets all data for a given subtype at a single record. If recordNum is invalid, or if no data of the given subtype exists at the record, will return an empty DataArray.

Exceptions
OpenTDExceptionThrown if the DataSubtype represents a character UDFA.

Implements OpenTD.Results.Dataset.IDataset.

◆ GetFluidSubmodels()

override List< string > OpenTD.Results.Dataset.DerivedDataset.GetFluidSubmodels ( )
inline

Gets all unique fluid submodel names from InputDatasets.

Returns
List<System.String>.

Implements OpenTD.Results.Dataset.IDataset.

◆ GetFtieIds()

override List< long > OpenTD.Results.Dataset.DerivedDataset.GetFtieIds ( string submodel)
inline

Gets all unique FTie numbers from InputDatasets for a given submodel.

Parameters
submodelThe submodel name.
Returns
List<System.Int64>.

Implements OpenTD.Results.Dataset.IDataset.

◆ GetIfaceIds()

override List< long > OpenTD.Results.Dataset.DerivedDataset.GetIfaceIds ( string submodel)
inline

Gets all unique IFace numbers from InputDatasets for a given submodel.

Parameters
submodelThe submodel name.
Returns
List<System.Int64>.

Implements OpenTD.Results.Dataset.IDataset.

◆ GetInternalIndex() [1/2]

long OpenTD.Results.Dataset.Dataset.GetInternalIndex ( DataTypes dataType,
string submodel,
long id )
abstractinherited

The 0-indexed position of the given Sinda entity in arrays returned by GetDataAtRecord. Returns -1 if entity can't be found.

See also
OpenTD.Results.Dataset.Dataset.GetDataAtRecord

Implements OpenTD.Results.Dataset.IDataset.

◆ GetInternalIndex() [2/2]

virtual long OpenTD.Results.Dataset.Dataset.GetInternalIndex ( string registerName)
inlinevirtualinherited

The 0-indexed position of the given register in arrays returned by GetRegisterDataAtRecord. Returns -1 if registerName can't be found.

See also
OpenTD.Results.Dataset.Dataset.GetRegisterDataAtRecord

Implements OpenTD.Results.Dataset.IDataset.

◆ GetLoopcoData()

List< long > OpenTD.Results.Dataset.Dataset.GetLoopcoData ( )
abstractinherited

◆ GetLoopctData()

List< long > OpenTD.Results.Dataset.Dataset.GetLoopctData ( )
abstractinherited

◆ GetLumpIds()

override List< long > OpenTD.Results.Dataset.DerivedDataset.GetLumpIds ( string submodel)
inline

Gets all unique lump numbers from InputDatasets for a given submodel.

Parameters
submodelThe submodel name.
Returns
List<System.Int64>.

Implements OpenTD.Results.Dataset.IDataset.

◆ GetNamedInt() [1/2]

long OpenTD.Results.Dataset.Dataset.GetNamedInt ( IntegerNames name)
inlineinherited

◆ GetNamedInt() [2/2]

long OpenTD.Results.Dataset.Dataset.GetNamedInt ( string name)
abstractinherited

◆ GetNamedIntArray() [1/2]

List< long > OpenTD.Results.Dataset.Dataset.GetNamedIntArray ( ArrayIntegerNames name)
inlineinherited

◆ GetNamedIntArray() [2/2]

List< long > OpenTD.Results.Dataset.Dataset.GetNamedIntArray ( string name)
abstractinherited

◆ GetNodeIds()

override List< long > OpenTD.Results.Dataset.DerivedDataset.GetNodeIds ( string submodel)
inline

Gets all unique node numbers from InputDatasets for a given submodel.

Parameters
submodelThe submodel name.
Returns
List<System.Int64>.

Implements OpenTD.Results.Dataset.IDataset.

◆ GetNpcsrec()

long OpenTD.Results.Dataset.Dataset.GetNpcsrec ( long recordNum)
abstractinherited

◆ GetNsol()

long OpenTD.Results.Dataset.Dataset.GetNsol ( long recordNum)
abstractinherited

◆ GetPathIds()

override List< long > OpenTD.Results.Dataset.DerivedDataset.GetPathIds ( string submodel)
inline

Gets all unique path numbers from InputDatasets for a given submodel.

Parameters
submodelThe submodel name.
Returns
List<System.Int64>.

Implements OpenTD.Results.Dataset.IDataset.

◆ GetPatmos()

Dimensional< Pressure > OpenTD.Results.Dataset.Dataset.GetPatmos ( )
abstractinherited

◆ GetRecordNames()

List< string > OpenTD.Results.Dataset.Dataset.GetRecordNames ( )
abstractinherited

◆ GetRecordNumbers()

List< long > OpenTD.Results.Dataset.Dataset.GetRecordNumbers ( )
abstractinherited

◆ GetRecordNumbersAsDataArray()

DataArray OpenTD.Results.Dataset.Dataset.GetRecordNumbersAsDataArray ( )
inlineinherited

◆ GetRegisterData()

override DataArray OpenTD.Results.Dataset.RecordFocusedDataset.GetRegisterData ( string registerName,
DataSubtype subtype = null,
UnitsData units = null )
inlineinherited

◆ GetRegisterDataAtRecord()

DataArray OpenTD.Results.Dataset.Dataset.GetRegisterDataAtRecord ( long recordNum,
DataSubtype subtype = null,
UnitsData units = null )
abstractinherited

Gets all register data at a single record. Use GetRegisterNames to get a list of register names in the same order as the data returned from this method. Or use GetInternalIndex to find the index of a specific register in this list. If recordNum is invalid, or if no register data exists at the record, will return an empty DataArray.

See also
OpenTD.Results.Dataset.Dataset.GetRegisterNames, OpenTD.Results.Dataset.Dataset.GetInternalIndex

Implements OpenTD.Results.Dataset.IDataset.

◆ GetRegisterNames()

override List< string > OpenTD.Results.Dataset.DerivedDataset.GetRegisterNames ( )
inline

Gets all unique register names from InputDatasets.

Returns
List<System.String>.

Implements OpenTD.Results.Dataset.IDataset.

◆ GetReliabilityData()

DataArray OpenTD.Results.Dataset.Dataset.GetReliabilityData ( long reliabilityNumber,
DataSubtype subtype = null,
UnitsData units = null )
abstractinherited

◆ GetSelfSuggestedComment()

virtual string OpenTD.Results.Dataset.Dataset.GetSelfSuggestedComment ( )
inlineprotectedvirtualinherited

◆ GetSelfSuggestedName()

virtual string OpenTD.Results.Dataset.Dataset.GetSelfSuggestedName ( )
inlineprotectedvirtualinherited

◆ GetSigma()

Dimensional< StefanBoltzmann > OpenTD.Results.Dataset.Dataset.GetSigma ( )
abstractinherited

◆ GetThermalSubmodels()

override List< string > OpenTD.Results.Dataset.DerivedDataset.GetThermalSubmodels ( )
inline

Gets all unique thermal submodel names from InputDatasets.

Returns
List<System.String>.

Implements OpenTD.Results.Dataset.IDataset.

◆ GetTieIds()

override List< long > OpenTD.Results.Dataset.DerivedDataset.GetTieIds ( string submodel)
inline

Gets all unique tie numbers from InputDatasets for a given submodel.

Parameters
submodelThe submodel name.
Returns
List<System.Int64>.

Implements OpenTD.Results.Dataset.IDataset.

◆ GetTimes()

DataArray OpenTD.Results.Dataset.Dataset.GetTimes ( )
abstractinherited

◆ GetTimesOrRecordNumbers()

DataArray OpenTD.Results.Dataset.Dataset.GetTimesOrRecordNumbers ( )
inlineinherited

◆ GetUdcaData()

override List< List< string > > OpenTD.Results.Dataset.RecordFocusedDataset.GetUdcaData ( DataItemIdentifierCollection dataItems)
inlineinherited

◆ GetUdcaDataAtRecord()

List< string > OpenTD.Results.Dataset.Dataset.GetUdcaDataAtRecord ( DataSubtype subtype,
long recordNum )
abstractinherited

Gets the UDFA of strings represented by a DataSubtype at a given record.

Parameters
recordNumRecord number from which to extract UDFA strings.
Returns
A list of character UDFA values.
Exceptions
OpenTDExceptionThrown if the DataSubtype represents a noncharacter UDFA.

Implements OpenTD.Results.Dataset.IDataset.

◆ GetUdfasAtRecord()

List< DataSubtype > OpenTD.Results.Dataset.Dataset.GetUdfasAtRecord ( long recordNum)
abstractinherited

Gets DataSubtypes UDFA at the given record number.

Parameters
recordNumRecord number from which to extract UDFA subtypes.
Returns
A list of DataSubtype objects.

Implements OpenTD.Results.Dataset.IDataset.

◆ Relay< T_collection, T_item >()

List< T_item > OpenTD.Results.Dataset.Dataset.Relay< T_collection, T_item > ( T_collection x)
inlineprotectedinherited
Type Constraints
T_collection :System.Collections.IEnumerable 

◆ Relay< T_item >()

List< T_item > OpenTD.Results.Dataset.Dataset.Relay< T_item > ( List< T_item > x)
inlineprotectedinherited

◆ ReOpen()

override void OpenTD.Results.Dataset.DerivedDataset.ReOpen ( )
inline

◆ ToString()

override string OpenTD.Results.Dataset.Dataset.ToString ( )
inlineinherited

◆ UnitsChangedSinceLastRead()

bool OpenTD.Results.Dataset.Dataset.UnitsChangedSinceLastRead ( )
inlineprotectedinherited

Property Documentation

◆ AutoCommenter

AutoCommenter OpenTD.Results.Dataset.Dataset.AutoCommenter
getsetprotectedinherited

◆ AutoNamer

AutoNamer OpenTD.Results.Dataset.Dataset.AutoNamer
getsetprotectedinherited

◆ Comment

string OpenTD.Results.Dataset.Dataset.Comment
getsetinherited

◆ InputDatasets

List<IDataset> OpenTD.Results.Dataset.DerivedDataset.InputDatasets
getset

The list of Datasets this derives its data from.

The input datasets.

See also
OpenTD.Results.Dataset.Dataset

◆ InternalSuggestedComment

string OpenTD.Results.Dataset.Dataset.InternalSuggestedComment
getsetinherited

◆ InternalSuggestedName

string OpenTD.Results.Dataset.Dataset.InternalSuggestedName
getsetinherited

◆ Name

string OpenTD.Results.Dataset.Dataset.Name
getsetinherited

◆ Source

override string OpenTD.Results.Dataset.DerivedDataset.Source
getprotected set

If the InputDatasets have a common source, it will be returned here.

The source.

Exceptions
OpenTDExceptionCannot set DerivedDataArray.SourceDataset directly. It will be derived from InputArrays.

Implements OpenTD.Results.Dataset.IDataset.

◆ UDFAManager

IUDFAManager OpenTD.Results.Dataset.Dataset.UDFAManager = null
getsetprotectedinherited

◆ Units

UnitsData OpenTD.Results.Dataset.Dataset.Units
getsetinherited

The unit system of the dataset.

Implements OpenTD.Results.Dataset.IDataset.


The documentation for this class was generated from the following file:
  • C:/Users/mgarrett/source/repos/BuildsTdSuite/builds/TDDEV_ALPHA/buildXX/OpenTD.Results/Dataset/DerivedDataset.cs

Connect with Ansys