    

 ## On this page

  

 

 # Class FormulaDataArray

 Last update: 09.03.2026 

Namespace: [OpenTD.Results.Dataset](OpenTD.Results.Dataset.md)  
Assembly: OpenTD.Results.dll

A DerivedDataArray that generate values using a formula that references 0 or more arrays from its InputCollection.

```csharp
public class FormulaDataArray : DerivedDataArray, IEnumerable<double>, IEnumerable

```

## Inheritance

[object](https://learn.microsoft.com/dotnet/api/system.object) ← [DataArray](OpenTD.Results.Dataset.DataArray.md) ← [DerivedDataArray](OpenTD.Results.Dataset.DerivedDataArray.md) ← [FormulaDataArray](OpenTD.Results.Dataset.FormulaDataArray.md)

## Implements

[IEnumerable&lt;double&gt;](https://learn.microsoft.com/dotnet/api/system.collections.generic.ienumerable-1), [IEnumerable](https://learn.microsoft.com/dotnet/api/system.collections.ienumerable)

## Inherited Members

[DerivedDataArray.InputCollection](OpenTD.Results.Dataset.DerivedDataArray.md#OpenTD_Results_Dataset_DerivedDataArray_InputCollection), [DerivedDataArray.IgnoreNaNInCalculations](OpenTD.Results.Dataset.DerivedDataArray.md#OpenTD_Results_Dataset_DerivedDataArray_IgnoreNaNInCalculations), [DerivedDataArray.SourceDataset](OpenTD.Results.Dataset.DerivedDataArray.md#OpenTD_Results_Dataset_DerivedDataArray_SourceDataset), [DerivedDataArray.SourceItem](OpenTD.Results.Dataset.DerivedDataArray.md#OpenTD_Results_Dataset_DerivedDataArray_SourceItem), [DerivedDataArray.GetValues(UnitsData)](OpenTD.Results.Dataset.DerivedDataArray.md#OpenTD_Results_Dataset_DerivedDataArray_GetValues_OpenTD_UnitsData_), [DerivedDataArray.Count](OpenTD.Results.Dataset.DerivedDataArray.md#OpenTD_Results_Dataset_DerivedDataArray_Count), [DerivedDataArray.this\[int\]](OpenTD.Results.Dataset.DerivedDataArray.md#OpenTD_Results_Dataset_DerivedDataArray_Item_System_Int32_), [DerivedDataArray.GetSelfSuggestedName()](OpenTD.Results.Dataset.DerivedDataArray.md#OpenTD_Results_Dataset_DerivedDataArray_GetSelfSuggestedName), [DerivedDataArray.SetDerivedData()](OpenTD.Results.Dataset.DerivedDataArray.md#OpenTD_Results_Dataset_DerivedDataArray_SetDerivedData), [DerivedDataArray.CheckData()](OpenTD.Results.Dataset.DerivedDataArray.md#OpenTD_Results_Dataset_DerivedDataArray_CheckData), [DataArray.SetValues(IEnumerable&lt;double&gt;, DataSubtype, UnitsData, ItemIdentifier)](OpenTD.Results.Dataset.DataArray.md#OpenTD_Results_Dataset_DataArray_SetValues_System_Collections_Generic_IEnumerable_System_Double__OpenTD_Results_Dataset_DataSubtype_OpenTD_UnitsData_OpenTD_Results_Dataset_ItemIdentifier_), [DataArray.SourceDataset](OpenTD.Results.Dataset.DataArray.md#OpenTD_Results_Dataset_DataArray_SourceDataset), [DataArray.SourceItem](OpenTD.Results.Dataset.DataArray.md#OpenTD_Results_Dataset_DataArray_SourceItem), [DataArray.Subtype](OpenTD.Results.Dataset.DataArray.md#OpenTD_Results_Dataset_DataArray_Subtype), [DataArray.SourceDataItem](OpenTD.Results.Dataset.DataArray.md#OpenTD_Results_Dataset_DataArray_SourceDataItem), [DataArray.Dimension](OpenTD.Results.Dataset.DataArray.md#OpenTD_Results_Dataset_DataArray_Dimension), [DataArray.IsInteger](OpenTD.Results.Dataset.DataArray.md#OpenTD_Results_Dataset_DataArray_IsInteger), [DataArray.GetValues()](OpenTD.Results.Dataset.DataArray.md#OpenTD_Results_Dataset_DataArray_GetValues), [DataArray.GetValues(UnitsData)](OpenTD.Results.Dataset.DataArray.md#OpenTD_Results_Dataset_DataArray_GetValues_OpenTD_UnitsData_), [DataArray.Count](OpenTD.Results.Dataset.DataArray.md#OpenTD_Results_Dataset_DataArray_Count), [DataArray.this\[int\]](OpenTD.Results.Dataset.DataArray.md#OpenTD_Results_Dataset_DataArray_Item_System_Int32_), [DataArray.ValuesSI](OpenTD.Results.Dataset.DataArray.md#OpenTD_Results_Dataset_DataArray_ValuesSI), [DataArray.CheckData()](OpenTD.Results.Dataset.DataArray.md#OpenTD_Results_Dataset_DataArray_CheckData), [DataArray.AutoNamer](OpenTD.Results.Dataset.DataArray.md#OpenTD_Results_Dataset_DataArray_AutoNamer), [DataArray.Name](OpenTD.Results.Dataset.DataArray.md#OpenTD_Results_Dataset_DataArray_Name), [DataArray.InternalSuggestedName](OpenTD.Results.Dataset.DataArray.md#OpenTD_Results_Dataset_DataArray_InternalSuggestedName), [DataArray.GetSelfSuggestedName()](OpenTD.Results.Dataset.DataArray.md#OpenTD_Results_Dataset_DataArray_GetSelfSuggestedName), [DataArray.ToString()](OpenTD.Results.Dataset.DataArray.md#OpenTD_Results_Dataset_DataArray_ToString), [DataArray.AutoCommenter](OpenTD.Results.Dataset.DataArray.md#OpenTD_Results_Dataset_DataArray_AutoCommenter), [DataArray.Comment](OpenTD.Results.Dataset.DataArray.md#OpenTD_Results_Dataset_DataArray_Comment), [DataArray.InternalSuggestedComment](OpenTD.Results.Dataset.DataArray.md#OpenTD_Results_Dataset_DataArray_InternalSuggestedComment), [DataArray.GetSelfSuggestedComment()](OpenTD.Results.Dataset.DataArray.md#OpenTD_Results_Dataset_DataArray_GetSelfSuggestedComment), [DataArray.GetEnumerator()](OpenTD.Results.Dataset.DataArray.md#OpenTD_Results_Dataset_DataArray_GetEnumerator), [object.ToString()](https://learn.microsoft.com/dotnet/api/system.object.tostring), [object.Equals(object)](https://learn.microsoft.com/dotnet/api/system.object.equals#system-object-equals(system-object)), [object.Equals(object, object)](https://learn.microsoft.com/dotnet/api/system.object.equals#system-object-equals(system-object-system-object)), [object.ReferenceEquals(object, object)](https://learn.microsoft.com/dotnet/api/system.object.referenceequals), [object.GetHashCode()](https://learn.microsoft.com/dotnet/api/system.object.gethashcode), [object.GetType()](https://learn.microsoft.com/dotnet/api/system.object.gettype), [object.MemberwiseClone()](https://learn.microsoft.com/dotnet/api/system.object.memberwiseclone)

## Constructors

### FormulaDataArray(DataArrayCollection)

```csharp
public FormulaDataArray(DataArrayCollection inputCollection)

```

#### Parameters

`inputCollection` [DataArrayCollection](OpenTD.Results.Dataset.DataArrayCollection.md)

### FormulaDataArray()

```csharp
public FormulaDataArray()

```

## Properties

### Formula

The formula to generate array values. Use "X0" to refer to the first array in the InputCollection, "X1" to refer to the second, etc. For formula syntax, see .NET docs for DataColumn.Expression. (<https://docs.microsoft.com/en-us/dotnet/api/system.data.datacolumn.expression?view=netcore-3.1>)

```csharp
public string Formula { get; set; }

```

#### Property Value

[string](https://learn.microsoft.com/dotnet/api/system.string)

### FormulaUnits

The units the forumla is written in, if applicable. The FormulaDataArray will automatically convert the InputCollection to these units before applying the formula. This is necessary for a formula like "X0 + 30", for example, when X0 is a temperature and 30 is in deg C. Defaults to the WorkingUnits.

```csharp
public UnitsData FormulaUnits { get; set; }

```

#### Property Value

UnitsData

### OutputCount

The number of items contained in the output array. This defaults to the maximum Count of any input array (if there are input arrays) or to 1 if there are no input arrays. This value can be set by the user.

```csharp
public int OutputCount { get; set; }

```

#### Property Value

[int](https://learn.microsoft.com/dotnet/api/system.int32)

### Subtype

The subtype of the formula result. Defaults to dimensionless, but can be set by the user.

```csharp
public override DataSubtype Subtype { get; set; }

```

#### Property Value

[DataSubtype](OpenTD.Results.Dataset.DataSubtype.md)

## Methods

### CheckData()

```csharp
protected override void CheckData()

```

### GetSelfSuggestedName()

```csharp
protected override string GetSelfSuggestedName()

```

#### Returns

[string](https://learn.microsoft.com/dotnet/api/system.string)

### SetDerivedData()

For setting ValuesSI, any other derived data

```csharp
protected override void SetDerivedData()

```