# Currency conversion

If you are working with series expressed in a variety of currencies it can be helpful to convert all the series to a single currency. In Macrobond there is an automatic currency conversion feature you can apply to your entire document.

Currency conversion works only if series has currency metadata. If series is a non-currency series then no calculation will be performed on it.

# How are exchange rates determined?

## Relevant parameters

Parameters which are taken into consideration in the process of converting currency are:

• the currency the series is expressed in,
• the frequency and properties of the input series,
• the method selected. The default method is 'Automatic'. (see What’s behind ‘Automatic’ method? for more information)

## How it's converted?

In the conversion process, Daily exchange rate series are used, but they are sometimes extended with data of a lower frequency if needed to get longer history.

1. The currency conversion takes place before the frequency conversion of the series in the document. (see The order of calculation for more information)
2. The application will search for a direct exchange series to calculate the conversion among the exchange rate series defined by Macrobond.
3. The application will find an exchange rate series that requires the fewest possible steps to calculate the conversion. Currently all exchange rate series used in Macrobond are specified with USD as the base rate, so in practice most of the exchanges are done via USD.

## Which series was used in conversion?

If you want to know exactly which series was used to perform the conversion, navigate to the Forecast tab in Series list. As you can see in the picture below, the FX series used for currency conversion are listed in addition to those added to the Series list.

If your series contain forecasts, you can also add forecasts to the series used for the currency conversion. See How to add a forecast values?.

## Currency conversion methods

All currency series are Daily. So, if series is in Daily frequency conversion is straightforward. When your series have a lower-than-Daily frequency there are several options for how to do the currency conversion.

After selecting currency in Currency box on Series list:

‘Currency conversion method’ box will become available under Conversion settings:

By default, all series are set to ‘Automatic’ (method is set according to the properties of the series) but you can change it manually to:

• Legacy
• First
• First 5d median
• Last
• Last 5d median
• Average
• None

## What’s behind ‘Automatic’ method?

The default setting is 'Automatic'. This means that the method will be decided according to the properties of the series:

• for Daily series we use ‘Last’,
• for other frequencies we use 'Last 5d median',
• for Flow series and series that we know are sampled in the middle of the period or are averages of the period, we use the 'Average',
• if we know that the series is sampled at the start of the period, we use 'First 5d median'.

## What’s behind ‘Legacy’ method?

This method was used in documents created before Macrobond version 1.22.

Relevant parameters which are taken into consideration in the process of converting currency are:

• the frequency and properties of the input series,
• the currency the series is expressed in.

The process of converting is a bit different because of the third step:

1. The currency conversion takes place before the frequency conversion of the series in the document. (see The order of calculation for more information)
2. The application will search for a direct exchange series to calculate the conversion.
3. Finally, the application will search for a series that matches the frequency of the document. If a corresponding frequency is not found, the closest higher frequency will be used and the first observation of the period.

# Applying currency conversion to a single series

If you only want to convert a specific series in your document, you can use the formula language and a suitable exchange rate series. In Series list please add series calculated as in these examples:

from HKD to USD

1/hkd
(to convert series use hkgdp*1/hkd)

from USD to NOK

usgdp*nok

Note that all exchange rates are in Daily frequency and they will change frequency of document (when set to 'Highest').

# Questions

## How does the currency conversion feature work when I change the frequency?

Exchange series are in Daily frequency, but what happen when you apply it to a non-Daily series and select its frequency as main?

If Currency conversion method is set to 'Automatic' the application chooses method according to properties of the series: 'Last 5d median', 'Average' or 'First 5d median'. For more information which applies to what series see What’s behind ‘Automatic’ method?.

## Why doesn’t currency conversion feature work on my series?

The whole process is based on series’ metadata. If series doesn’t have them, currency conversion won’t work.

"ih:bl:ndueacwf index:PX_LAST:Curr=ZAR"