# Consumption per Category

> Symcon documentation · English · generated on 2026-09-26  
> Index: https://www.symcon.de/en/llms.txt

Source: https://www.symcon.de/en/service/documentation/module-reference/energy/consumption-per-category/

_Requires Symcon >= 6.3_

Calculates consumption in percent per freely selectable category according to specified start and end dates. The calculation is based on daily aggregation.

### function scope

* Selection of multiple variables
* Free text for category

### software installation

* Install the 'Consumption per category' module via the Module Store.

### Instance setup in IP-Symcon

 Under 'Add instance' the 'Consumption per category' module can be found using the quick filter.
	- More information about adding instances in the [Instances documentation](https://www.symcon.de/service/dokumentation/konzepte/instanzen/#Instanz_hinzufügen)

__Configuration page__:

| Name     | Description                                                 |
| -------- | ----------------------------------------------------------- |
| Interval | Interval in which the calculation is executed. 0 = Disabled |
| Sources  | List of variables and categories                            |

### status variables

The status variables/categories are created automatically. Deleting individual ones can lead to malfunctions.

#### Status variables

| Name       | Type    | Description                                                                                                                                                                                                                                             |
| ---------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Category   | Float   | A variable is created per category, in which the percentage consumption is displayed. The category name is internally reduced to A-Z, a-z, 0-9 and _ (underscore). This means that the category "Test" and "Test €" will also be categorized to "Test". |
| Start time | Integer | Date from when the calculation should start                                                                                                                                                                                                             |
| End time   | Integer | Date until when the calculation should go                                                                                                                                                                                                               |

## VIK_CalculationConsumption

Source: https://www.symcon.de/en/service/documentation/module-reference/energy/consumption-per-category/vik-calculationconsumption/

`bool VIK_CalculateConsumption(int $InstanceID)`

_Requires Symcon >= 6.3_

Recalculates the categories

**Parameters**

- `$InstanceID` (int): Instance Id

**Returns** (bool): If the command could be executed successfully, it returns** TRUE** as result, otherwise **FALSE**.

Instance Id

**Example**

```php
VIK_CalculateConsumption(12345);
```