# Overview

The* Scalar* analysis is a tool for extracting particular values or metrics and comparing them across series. Use this analysis when you want to create a chart with categories, such as countries, along the x-axis, and columns of values on the y-axis.

The scalar analysis can perform a variety of calculations that result in one value per input series, such as the last value, the mean in a time range, or year to date performance. The output is always a category series, meaning that the time variable is replaced by a categorical variable. You can display this output in a category chart, bar chart, or category scatter chart.

# Settings

## Input series

This is a list of the series in your document that you can include in the scalar analysis. That a series is ‘included’ means that the added calculations will be performed on it, and the resulting values will be included in the output series. You can also select whether new series that you add to your document should be automatically included in the calculations (added in version 1.18).

The order of the series in this list determines the order of the values in the output series. You can adjust the order by clicking and dragging series, or sort them alphabetically by clicking ‘sort’. Sorting is done by region followed by maturity length, price type and, if all else equal or not available, alphabetically by title.

## Automatic attributes for Value labels

By default, Value Labels are generated using the non-common elements of the series descriptions. This works well for series using harmonized descriptions.

In certain cases, you might end up with very long value labels. To avoid this, this setting allows you to pick from a list of attributes you want to display to automatically generate the value labels.

## Calculations

Here, you can add one or more calculations that will be performed on all of the selected input series. The available calculations are:

*Open, High, Low, Close*

The first, highest, lowest or last value of the specified range.

*Mean, Median, Standard deviation*

The mean, median or standard deviation of the range.

*Last*

The last valid value of each series.

*Last common*

The value at the last point in time at which all the included series have values (available in version 1.18 and later).

*Last non-forecast*

The last value that is not a forecast in the series.

*Value at*

The value at a specific point in time. If a series is missing a value for that date, the first available value before that date will be used.

*Nth last value*

The nth last value of a series, where a value of 1 gives the last value, 2 gives the second value to last, 3 gives the third value to last etc.

*Percentile*

The specified percentile of the selected range.

*Lower, Upper tail mean*

The mean of the values in the upper or lower percentile of the range.

*Year, Quarter, Month, Week to date*

The performance from the start of the period to the specified date. The performance is measured as the change compared to the last value of the previous period.*

*Performance since*

The performance between two specified dates. The performance is measured as the change compared to the last value of the previous period.*

*Years, Quarters, Months, Weeks back*

The change from a selected number and type of periods before the specified date.*

For years and quarters, this is the same as using the “Rate of change since” method and specifying the start of the range as “-1y” or “-1q”.

*Rate of change since*

The rate of change between two points in time*

*Percentage proportion*

The percentage proportion of each series compared to the sum of all series at a specified point in time.

### *Relative dates

Most scalar calculations require either a point in time or a time interval to be specified. You can use specific dates, but you may want the dates to update when new data is added. In that case, leaving the date box blank or using relative dates, such as ‘-1y’, can be useful. It’s important to understand what default dates are chosen when none is specified, and how relative dates work in each context.

#### Point in time

First, we’ll talk about calculations that require only one point in time, such as *value at*. If the *point in time* box is left blank, the last valid value for each series will be used.

If you specify a relative date here, that date will be relative to the last calendar date, not relative to the last date for each series. If you would like the last calendar date to be used, even though not all series may have values, you should use the relative date “+0”.

#### Time intervals

If you leave the range start blank, the first available value for each series is used. If you leave the range end blank, the last available value for each series is used.

When you use a relative date for the range start and leave the range end blank, the end point will be the last valid value for each series and the starting point for each series will be relative to its last point, not the last calendar date.

If you use relative dates for both the range start and the range end, they will both be relative to the last calendar date.

## Value labels

These are the categories of the output series produced. A tip for when you want to know what your chart will look like is to look at these categories listed as value labels. They are also the labels that will appear on the x-axis of your category chart, or the right side of your bar chart.

## Output series

There are four possible ways of organizing your output. The one you should choose depends on:

- Whether you want to group your input series, and
- What categories you would like on the x-axis

These four options can be divided into two types based on whether or not you would like to group the input series.

### One series per calculation & one series per input

Choose one of these two settings when you **do not **want to group your input series. The categories on the x-axis, then, are either the series names or scalar calculations.

*One series per calculation*: Use this setting when you want the input series names on the x-axis. It creates one category series per scalar calculation done, where the categories are the input series. Example:

*One series per input*: Use this setting when you would like the x-axis to contain the names of the calculations you’ve done in scalar. It produces one output series per input series, where the categories are the calculations done. Example:

### New group after every *n* series &

Choose one of these settings when you do** want to group** the input series by some series descriptor, such as country. Switching between the two settings will switch which series descriptor is the category on the x-axis (value label), as illustrated by the example below.

- New group after every

- Partition into

These output of this setting also depends on the order of the series in the input series list. Pay attention to the group number that appears next to the series.

Series with the same group number make up the same output series. The application creates the output categories based on the descriptors that are **not** common within these groups.

# Methods

Rates of change as *value*, *percentage* or *logarithmic* are calculated in the following way:

- $\mathrm{value}=y\left[t\right]\u2013y\left[t\u2013n\right]$
- $\mathrm{percentage}=100\frac{y\left[t\right]\u2013y\left[t\u2013n\right]}{|y\left[t\u2013n\right]|}$
- $\mathrm{logarithmic}=100\text{ln}\frac{y\left[t\right]}{y\left[t\u2013n\right]}$
- $\mathrm{annualRateValue}=\frac{c}{h}\sum _{i=1}^{h}\text{z}\left(t+1\u2013i\right)$
- $\mathrm{annualRatePercent}=\text{100}\left({\left(\frac{\text{z}\left(t\right)}{\text{z}\left(t\u2013h\right)}\right)}^{\frac{c}{h}}\u20131\right)$

where *c* is the typical number of observations in one year.

# Examples

In this example, we calculated the average GDP growth per decade by adding one "Mean" calculation per decade. We also used the setting "One series per input". This means that one series will be created for each input series that we use. We have 6 countries, so 6 category series will be created, one per country.

We used the scalar analysis to produce a single category series for the YTD performance. Here, "One series per calculation" means that one category series will be created per calculation applied.