Appearance

# Resources Forecast Object Reference

This **ResourcesForecast** object is a collection of time-series forecasts for resources and their key performance metrics with respect to the selected **SimulationType** property value.

INFO

Time-series intervals may vary in duration. Values that rely on calculated averages are time-weighted to account for different durations.

## Financial Kpi

This **FinancialKpi** object contains financial key performance indicators.

json

```
{
"Kratio": 2.85,
"KratioShift": false,
"AvgServerQty": 163.7,
"AvgProcessorQty": 327.4,
"AvgCoreQty": 3230.2,
"NominalPerServerUnitCost": 24491.5,
"NominalPerProcessorUnitCost": 12245.8,
"NominalPerCoreUnitCost": 1241.2,
"TotalCost": 20326958,
"TotalCostPerYear": 4009262
}
```

#### Attributes

##### Kratio - numeric

###### Ratio of software, power and facility resource costs to server cost, calculated using interval duration weighting.

TIP

When the **SimulationType** selected is 'OptimalYield', this **Kratio** property value *is* the optimal Kratio (i.e., the optimal resource mix) for the entire time-series.

##### KratioShift - boolean

###### A flag to identify the Kratio incurred a linear shift caused by a Performance Jump Event.

##### AvgServerQty - numeric

###### Average Server quantity for entire time-series based on interval duration weighting.

##### AvgProcessorQty - numeric

###### Average Processor quantity for entire time-series based on interval duration weighting.

##### AvgCoreQty - numeric

###### Average Core quantity for entire time-series based on interval duration weighting.

##### NominalPerServerUnitCost - numeric

###### Calculated cost per server calculated as: Annualized Total Cost / Average Server Quantity.

##### NominalPerProcessorUnitCost - numeric

###### Calculated cost per processor calculated as: Annualized Total Cost / Average Processor Quantity.

##### NominalPerCoreUnitCost - numeric

###### Calculated cost per core calculated as: Annualized Total Cost / Average Server Quantity.

##### TotalCost - integer

###### Total cumulative cost for entire time-series.

##### TotalCostPerYear - integer

###### Annualized Total Cost calculated as: Total Cost / Time-series duration

## Financial Summary Item

This **FinancialSummaryItem** object contains resource costs of an time-interval within a time-series result.

json

```
{
"IntervalNbr": 5,
"AbsTimeStart": 0.89,
"AbsTimeEnd": 1,
"ServerIncCost": 0,
"PerpetualLicenseIncCost": 114901,
"SupportIncCost": 151406,
"SubscriptionIncCost": 121335,
"PowerIncCost": 5704,
"FacilityIncCost": 9679,
"TotalIncCost": 403025,
"ServerCumCost": 0,
"PerpetualLicenseCumCost": 202693,
"SupportCumCost": 1359030,
"SubscriptionCumCost": 1129197,
"PowerCumCost": 57983,
"FacilityCumCost": 94467,
"TotalCumCost": 2843370,
"TotalPerYearCumCost": 2843370,
"TotalPerCapacityCumCost": 247,
"TotalPerYearPerCapacityCumCost": 247,
"Kratio": null
}
```

#### Attributes

##### IntervalNbr - integer

###### Interval number within time-series.

##### AbsTimeStart - numeric

###### Absolute start time of interval in years.

##### AbsTimeEnd - numeric

###### Absolute end time of interval in years.

##### ServerIncCost - integer

###### Net incremental cost of server additions and removals, plus residual value, for interval.

##### PerpetualLicenseIncCost - integer

###### Incremental cost for new perpetual licenses added in interval.

##### SupportIncCost - integer

###### Ongoing support cost for perpetual licenses for interval.

##### SubscriptionIncCost - integer

###### Current subscription license costs for interval.

##### PowerIncCost - integer

###### Power consumption costs for interval.

##### FacilityIncCost - integer

###### Facility space consumption for interval.

##### TotalIncCost - integer

###### Sum of all incremental cost for interval.

##### ServerCumCost - integer

###### Cumulative of server incremental cost for all prior intervals plus current interval.

##### PerpetualLicenseCumCost - integer

###### Cumulative of perpetual incremental cost for all prior intervals plus current interval.

##### SupportCumCost - integer

###### Cumulative of support incremental cost, for perpetual licenses, for all prior intervals plus current interval.

##### SubscriptionCumCost - integer

###### Cumulative of subscription incremental cost for all prior intervals plus current interval.

##### PowerCumCost - integer

###### Cumulative of power incremental cost for all prior intervals plus current interval.

##### FacilityCumCost - integer

###### Cumulative of facility space incremental cost for all prior intervals plus current interval.

##### TotalCumCost - integer

###### Sum of all cumulative costs for all prior intervals plus current interval.

##### TotalPerYearCumCost - integer

###### Sum of all cumulative costs divided by current interval's absolute time end.

##### TotalPerCapacityCumCost - integer

###### Sum of all cumulative costs divided by current interval's total scalar capacity rating per **CapacityCum** property of **HardwareSummary** object.

##### TotalPerYearPerCapacityCumCost - integer

###### Sum of all cumulative costs divided by current interval's absolute time end and divided by current interval's total scalar capacity rating.

##### Kratio - numeric

###### Sum of all software, power and facility cumulative cost divided by server cumulative cost. Value is null if server cumulative cost is zero.

## Hardware Kpi

This **HardwareKpi** object contains hardware key performance indicators.

json

```
{
"PerformanceCaptureYield": 0.98,
"ServerAverageAge": 1.78,
"ServerAverageRemovalAge": 4.56,
"AnnualRemovalPercent": 0.2,
"AnnualAddPercent": 0.2,
"MaxServerQty": 244,
"MaxServerQtyTime": 4.86,
"MaxProcessorQty": 488,
"MaxProcessorQtyTime": 4.86,
"MaxCoreQty": 4880,
"MaxCoreQtyTime": 4.86
}
```

#### Attributes

##### EfficiencyCaptureYield - numeric

###### Indicator of server 'freshness' relative to the current market performance rating.

TIP

Why is 'freshness' an important metric? Because operating server inventory for too long incurs both technology currency and financial opportunity costs.

Currency refers to how 'current' or accepted as up-to-date. For example, the server may no longer be supported by its vendor.

Financial opportunity cost corresponds to how a less efficient or performant server causes unnecessarily higher consumption rates for other resources, which often far exceed the purchase cost of new, more efficient or performant server.

##### ServerAverageAge - numeric

###### Weighted-average age of server inventory.

##### ServerAverageRemovalAge - numeric

###### Weighted-average age of servers removed from inventory.

##### AnnualRemovalPercent - numeric

###### Annualized percent of servers removed from inventory.

##### AnnualAddPercent - numeric

###### Annualized percent of servers added to inventory.

##### MaxServerQty - integer

###### Peak quantity of servers in time-series.

##### MaxServerQtyTime - integer

###### Time (years) when peak quantity of servers was first reached.

##### MaxProcessorQty - integer

###### Peak quantity of processors in time-series.

##### MaxProcessorQtyTime - numeric

###### Time (years) when peak quantity of processors was first reached.

##### MaxCoreQty - integer

###### Peak quantity of cores in time-series.

##### MaxCoreQtyTime - numeric

###### Time (years) when peak quantity of cores was first reached.

## Hardware Summary Item

This **HardwareSummaryItem** object contains server inventory of an time-interval within a time-series result.

json

```
{
"IntervalNbr": 11,
"AbsTimeStart": 1.88,
"AbsTimeEnd": 2,
"DemandStart": 8775,
"DemandDelta": 195,
"DemandEnd": 8970,
"UtilizationStart": 63.587,
"UtilizationEnd": 65,
"RackIncQty": null,
"ServerIncQty": 3,
"ProcessorIncQty": 6,
"CoreIncQty": 60,
"CapacityInc": 300,
"RackCumQty": null,
"ServerCumQty": 138,
"ProcessorCumQty": 276,
"CoreCumQty": 2760,
"CapacityCum": 13800,
"CapacityPerServer": 100,
"CapacityPerProcessor": 50,
"CapacityPerCore": 5,
"ServerAvgAge": 1.25,
"ServerAvgRemovalAge": 4.01,
"TransactionPercentAdd": 1,
"TransactionPercentRemove": 1,
"PerformanceCaptureYield": 1
}
```

#### Attributes

##### IntervalNbr - integer

###### Interval number within time-series.

##### AbsTimeStart - numeric

###### Absolute start time of interval in years.

##### AbsTimeEnd - numeric

###### Absolute end time of interval in years.

##### DemandStart - numeric

###### Scalar value for demand at interval start.

##### DemandDelta - numeric

###### This interval's incremental scalar value for demand.

##### DemandEnd - numeric

###### Scalar value for demand at interval end.

##### UtilizationStart - numeric

###### Pool utilization rate at interval start.

##### UtilizationEnd - numeric

###### Pool utilization rate at interval end.

##### RackIncQty - integer

###### Incremental change to pool's rack quantity. Only valid if **LotType** property in **LotConfiguration** object is set to 'Rack'. If not, value is null.

##### ServerIncQty - integer

###### Incremental change to pool's server quantity.

##### ProcessorIncQty - integer

###### Incremental change to pool's processor quantity.

##### CoreIncQty - integer

###### Incremental change to pool's core quantity.

##### CapacityInc - integer

###### Incremental change to pool's aggregate performance rating (aka Capacity).

##### RackCumQty - integer

###### Cumulative quantity of racks in pool.

##### ServerCumQty - integer

##### Cumulative quantity of servers in pool.

##### ProcessorCumQty - integer

###### Cumulative quantity of processors in pool.

##### CoreCumQty - integer

###### Cumulative quantity of cores in pool.

##### CapacityCum -integer

###### Cumulative capacity of pool.

##### CapacityPerServer - numeric

###### Capacity per server, calculated as: CapacityCum / ServerCumQty;

##### CapacityPerProcessor - numeric

###### Capacity per processor, calculated as: CapacityCum / ProcessorCumQty;

##### CapacityPerCore - numeric

###### Capacity per core, calculated as: CapacityCum / CoreCumQty;

##### ServerAvgAge - numeric

###### The average time duration a server exists in pool inventory. Can only be calculated if the **InitialAge** property in **ServerInventory** object is set. Otherwise, returns null.

##### ServerAvgRemovalAge - numeric

###### Time-weighted average age of servers removed from the pool. If initial age of servers was not included, calculation will be based only those servers added and removed from the pool within the time-series.

##### TransactionPercentAdd - integer

###### Quantity of servers added relative to server cumulative quantity.

##### TransactionPercentRemove - integer

###### Quantity of servers removed relative to server cumulative quantity.

TIP

Inventory turnover is usually a single number. Because higher performance servers are being added and lower performance servers are being removed, hardware inventory turnover is ** asymmetric** and therefore ingress and egress are measured.

##### PerformanceCaptureYield - numeric

###### Measures performance capture yield of inventory turnover, and calculated as: weighted-average capacity rating of server inventory divided by current capacity rating in **ServerUnitCapacity** property in **NewServerConfiguration** object

TIP

Performance capture yield indicates server inventory 'freshness.' Managing hardware inventory is perishable on two dimensions:

- Asset values quickly decay with the arrival of better hardware.
- Usage is time sensitive and therefore perishable. Lack of utilization yesterday cannot be made up by today's utilization.

## Hardware Detail Item

This **HardwareDetailItem** object contains server inventory transactions of a time-interval within a time-series result.

json

```
{
"IntervalNbr": 11,
"UniqueIdentifier": "svr-3-0-2-475",
"AbsTimeStart": 1.88,
"AbsTimeEnd": 2,
"SourceIntervalNbr": 11,
"ServerQty": 3,
"RackQty": null,
"ProcessorQty": 6,
"CoreQty": 60,
"TotalCapacity": 300,
"ServerUnitCapacity": 100,
"ProcessorUnitCapacity": 50,
"CoreUnitCapacity": 5,
"ProcessorSetSize": 2,
"CoreSetSize": 10,
"WattsRating": 1200,
"RackSpaceUnit": 1
}
```

#### Attributes

##### IntervalNbr - integer

###### Current interval number within time-series.

##### UniqueIdentifier - string

###### Unique transaction code

##### AbsTimeStart - numeric

###### Absolute start time of interval in years.

##### AbsTimeEnd - numeric

###### Absolute end time of interval in years.

##### SourceIntervalNbr - integer

###### Source interval number that originated the transaction.

##### ServerQty - integer

##### Quantity of Servers added or removed.

##### RackQty - integer

###### Quantity of racks added or removed. Null indicates **LotType** property in **LotConfiguration** object is not set to 'Rack'.

##### ProcessorQty - integer

###### Quantity of processor added or removed.

##### CoreQty - integer

###### Quantity of cores added or removed.

##### TotalCapacity - integer

##### ServerUnitCapacity - numeric

###### Server unit capacity.

##### ProcessorUnitCapacity numeric

###### Processor unit capacity.

##### CoreUnitCapacity - numeric

###### Core unit capacity

##### ProcessorSetSize - integer

###### Quantity of processor sockets used. For example, a two-socket server with one cpu is counted as 1.

##### CoreSetSize - integer

###### Quantity of cores per processor.

##### WattsRating - integer

###### Nominal watts rating of server.

##### RackSpaceUnit - integer

###### Size of server in U unit (e.g., 1U, 2U, etc.).

## Software Kpi

This **SoftwareKpi** object contains software key performance indicators.

json

```
{
"ServerEntitlementsAvgUtilizationPercent": 98.6,
"ProcessorEntitlementsAvgUtilizationPercent": 98.6,
"CoreEntitlementsAvgUtilizationPercent": 100,
"ServerAvgExcessEntitlementsQty": 2,
"ProcessorAvgExcessEntitlementsQty": 3,
"CoreAvgExcessEntitlementsQty": 0
}
```

#### Attributes

##### ServerEntitlementsAvgUtilizationPercent - numeric

###### Weighted average utilization percentage of server entitlements.

##### ProcessorEntitlementsAvgUtilizationPercent - numeric

###### Weighted average utilization percentage of processor entitlements.

##### CoreEntitlementsAvgUtilizationPercent - numeric

###### Weighted average utilization of core entitlements.

##### ServerAvgExcessEntitlementsQty - integer

###### Weighted average quantity of excess server entitlements.

##### ProcessorAvgExcessEntitlementsQty - integer

###### Weighted average quantity of excess server entitlements.

##### CoreAvgExcessEntitlementsQty - integer

###### Weighted average quantity of excess core entitlements.

## Software Summary Item

This **SoftwareSummaryItem** object contains software inventory of a time-interval within a time-series result.

json

```
{
"IntervalNbr": 12,
"AbsTimeStart": 2,
"AbsTimeEnd": 2.2,
"RequiredServerQty": 143,
"RequiredProcessorQty": 286,
"RequiredCoreQty": 2860,
"AvailableServerQty": 143,
"AvailableProcessorQty": 286,
"AvailableCoreQty": 2860,
"UtilizationPercentServer": 100,
"UtilizationPercentProcessor": 100,
"UtilizationPercentCore": 100
}
```

#### Attributes

##### IntervalNbr - integer

###### Interval number within time-series.

##### AbsTimeStart - numeric

###### Absolute start time of interval in years.

##### AbsTimeEnd - numeric

###### Absolute end time of interval in years.

##### RequiredServerQty - integer

###### Quantity of server licenses required.

##### RequiredProcessorQty - integer

###### Quantity of processor licenses required.

##### RequiredCoreQty - integer

###### Quantity of core licenses in required.

##### AvailableServerQty - integer

###### Position quantity of server licenses.

##### AvailableProcessorQty - integer

###### Position quantity of processor licenses.

##### AvailableCoreQty - integer

###### Position quantity of core licenses.

##### UtilizationPercentServer - integer

###### Percentage of server licenses utilized.

##### UtilizationPercentProcessor - integer

###### Percentage of processor licenses utilized.

##### UtilizationPercentCore - integer

###### Percentage of core licenses utilized.

## Software Detail Item

This **SoftwareDetailItem** object contains software transactions of a time-interval within a time-series result.

INFO

Software contract term dates differ from generated intervals in the result time-series. Contract events (i.e., annual entitlement settlement or contract renewal) are not forced by Zypr to match generated interval dates. Software contract dates will therefore likely fall *within* a time-series interval. The 'start' and 'end' properties for entitled and excess values account for that difference and result in 'start' and 'end' values that may differ if the **EntitlementExtremaResetBasis** property in **SoftwareItemTerms** is set to 'InterContract' or 'IntraContract' reset. Usually these two values will be the same.

json

```
{
"LicenseId": 1,
"LicenseTypeName": "PerpetualSupport",
"LicenseMetricName": "Core",
"IntervalNbr": 15,
"AbsTimeStart": 2.5,
"AbsTimeEnd": 2.68,
"RequiredQty": 3120,
"AvailableQtyStart": 3120,
"AvailableQtyEnd": 3120,
"ExcessQtyStart": 0,
"ExcessQtyEnd": 0
}
```

#### Attributes

##### LicenseId - integer

###### Unique number identify product.

##### LicenseTypeName - string

###### Type of license (e.g., perpetual).

##### LicenseMetricName - string

###### Metric used by a vendor for counting license consumption.

##### IntervalNbr - integer

###### Interval number within time-series.

##### AbsTimeStart - numeric

###### Absolute start time of interval in years.

##### AbsTimeEnd - numeric

###### Absolute end time of interval in years.

##### RequiredQty - integer

###### Quantity of licenses in use.

##### AvailableQtyStart - integer

###### Position quantity of available licenses at start of interval.

##### AvailableQtyEnd - integer

###### Position quantity of licenses at end of interval.

##### ExcessQtyStart - integer

###### Excess quantity of licenses at start of interval.

##### ExcessQtyEnd - integer

###### Excess quantity of licenses at end of interval.

## Facility Kpi

This **FacilityKpi** object contains facility key performance indicators.

json

```
{
"RackSlotAvgQty": 164,
"RackSlotQtyAnnualizedChangePercent": 13.6,
"CapacityPerRackSlotAnnualizedChangePercent": 5.6,
"KWhPerCapacityUnitAnnualizedChangePercent": -6.3,
"KWhPerRackSlotAnnualizedChangePercent": -1.2
}
```

#### Attributes

##### RackSlotAvgQty - integer

###### Weighted average rack slot quantity consumed.

##### RackSlotQtyAnnualizedChangePercent - numeric

###### Annualized growth rate of rack units consumed. A rack unit is 1U.

##### CapacityPerRackSlotAnnualizedChangePercent - numeric

###### Annualized growth rate of kilowatt hours consumed.

##### KWhPerCapacityUnitAnnualizedChangePercent - numeric

###### Annualized growth rate of kilowatt hours per capacity unit.

##### KWhPerRackSlotAnnualizedChangePercent - numeric

###### Annualized growth rate of kilowatt hours per rack unit.

## Facility Summary Item

This **FacilitySummaryItem** object contains facility resources of a time-interval within a time-series result.

TIP

Facility resources may be treated as a fixed or semi-fixed costs by setting the **SimulationScope** object to exclude all facility costs. An optimal solution will therefore not include any potential facility cost displacement.

json

```
{
"IntervalNbr": 14,
"AbsTimeStart": 2.39,
"AbsTimeEnd": 2.5,
"RackSlotQtyInc": 3,
"RackSlotQtyCum": 151,
"ComputeCapacityPerRackSlot": 100,
"KilowattHrsInc": 74498,
"KilowattHrsAnnualized": 677255,
"KilowattHrsAnnualizedPerCapacityUnit": 44.9,
"KilowattHrsAnnualizedPerRackSlot": 4485.1
}
```

#### Attributes

##### IntervalNbr - integer

###### Interval number within time-series.

##### AbsTimeStart - numeric

###### Absolute start time of interval in years.

##### AbsTimeEnd - numeric

###### Absolute end time of interval in years.

##### RackSlotQtyInc - integer

###### Incremental 1U rack slot quantity.

##### RackSlotQtyCum - integer

###### Cumulative 1U rack slot quantity.

##### ComputeCapacityPerRackSlot - integer

###### Capacity per 1U rack size.

##### KilowattHrsInc - integer

###### Incremental kilowatt hours consumed.

##### KilowattHrsAnnualized - integer

###### Annualized kilowatt hours consumed.

##### KilowattHrsAnnualizedPerCapacityUnit - numeric

###### Annualized kilowatt hours consumed per unit of capacity.

##### KilowattHrsAnnualizedPerRackSlot - numeric

###### Annualized kilowatt hours consumed per 1U rack size.

## Facility Detail Item

This **FacilityDetailItem** object contains facility use transactions of a time-interval within a time-series result.

json

```
{
"IntervalNbr": 4,
"AbsTimeStart": 0.71,
"AbsTimeEnd": 0.89,
"SourceIntervalNbr": 0,
"RackSlotQtyInc": -8,
"RackSlotQtyCum": 99,
"TotalKilowattHrs": -5235,
"ProcessorSetSize": 2,
"CoreSetSize": 8,
"WattsRating": -3320,
"ServerSize": 1
}
```