> Documentation index: https://www.gooddata.ai/docs/gooddata-ui/llms.txt lists every page of these docs as Markdown.

# IDataSeries

- Package: [@gooddata/sdk-ui](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui/index.md)
- Kind: interface
- Source: https://github.com/gooddata/gooddata-ui-sdk/blob/rel/11.64/libs/sdk-ui/src/base/results/dataAccess.ts

Data series is a sequence of data points that are all computed from a single measure, scoped for particular attribute elements.

**Signature:**

```typescript
export interface IDataSeries extends DataSeriesDescriptorMethods, Iterable<DataPoint> 
```
**Extends:** [DataSeriesDescriptorMethods](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui/sdk-ui.dataseriesdescriptormethods/index.md), Iterable&lt;[DataPoint](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui/sdk-ui.datapoint/index.md)&gt;

## Remarks

In other words, data series allows iterating over two dimensional data view \_along\_ the dimension which contains the measures (via inclusion of MeasureGroupIdentifier).

For convenience, the data series is iterable over Data Points. You can use it either in for-of loop or spread data series into an array of [DataPoints](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui/sdk-ui.datapoint/index.md).

## Properties

| Property | Modifiers | Type | Description |
| --- | --- | --- | --- |
| [descriptor](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui/sdk-ui.idataseries/index.md#idataseriesdescriptor) | `readonly` | [DataSeriesDescriptor](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui/sdk-ui.dataseriesdescriptor/index.md) | Descriptor of this data series - what measure it was calculated from, whether it is scoped and if so to what attribute headers. |
| [id](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui/sdk-ui.idataseries/index.md#idataseriesid) | `readonly` | [DataSeriesId](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui/sdk-ui.dataseriesid/index.md) | Unique identifier of the data series. This can be used to directly access this data series from data view. |

## Methods

| Method | Description |
| --- | --- |
| [dataPoints()](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui/sdk-ui.idataseries/index.md#idataseriesdatapoints) |  |
| [rawData()](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui/sdk-ui.idataseries/index.md#idataseriesrawdata) |  |

## Property details

### IDataSeries.descriptor

Descriptor of this data series - what measure it was calculated from, whether it is scoped and if so to what attribute headers.

**Signature:**

```typescript
readonly descriptor: DataSeriesDescriptor;
```

### IDataSeries.id

Unique identifier of the data series. This can be used to directly access this data series from data view.

**Signature:**

```typescript
readonly id: DataSeriesId;
```

## Method details

### IDataSeries.dataPoints()

**Signature:**

```typescript
dataPoints(): DataPoint[];
```
**Returns:**

[DataPoint](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui/sdk-ui.datapoint/index.md)[]

- all data points in this series

#### Remarks

the series is iterable over data points; if you want to iterate using for-of loop then it is not  necessary to call this method - just use `for (const dataPoint of series) {...}`

### IDataSeries.rawData()

**Signature:**

```typescript
rawData(): DataValue[];
```
**Returns:**

[DataValue](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-model/sdk-model.datavalue/index.md)[]

- all raw, unformatted data for this series.

#### Remarks

if you need to work with fully annotated and formatted data, use the DataPoint iterator.
