What is a portfolio mapping and how do I create one?

A portfolio mapping is preselected set of configuration options for a portfolio or portfolio group in the Rebalance dashboard.

You can create a portfolio mapping for a portfolio or portfolio group once and specify:

• A valuation recipe

• A rebalance configuration

• A currency

• One or more models and/or benchmarks

The Rebalance dashboard thereafter populates the mapping values automatically when a user selects that particular portfolio or portfolio group.

Note

When you add a mapping to a portfolio group, LUSID treats the group as a single portfolio.

Setting up a portfolio mapping

To set up a portfolio mapping:

1. Sign in to the LUSID web app and navigate to Portfolio Management > Rebalance via the top left menu.

2. Select Add mapping.
   

3. Specify a portfolio mapping Display Name and select the following:

   • An existing recipe; this recipe overrides any existing recipe chosen in the Rebalance dashboard

   • A Rebalance Configuration containing rules for the portfolio or portfolio group; read more

   • The default (display) Currency for the portfolio or portfolio group; note the default currency can differ from the portfolio currency

   

4. Optionally, select the corresponding headers to specify any of the following:

   • Under Model, one or more portfolio models and their weightings; you can select both reference and transaction portfolio types

   • Under Benchmark, one benchmark portfolio

   • Under Cash Equitisation, one or more portfolios and targets; see how to run cash equitisation

   • A currency exposure Hedging Policy, Model, and Overlay

   

5. Select Save to complete your portfolio mapping.

Once saved, your Rebalance dashboard populates the relevant columns according to your selections:

Rebalance configuration

The rebalance configuration defines a set of parameters and preferences to apply to your Rebalance dashboard and generated orders.

General

Equivalent security identifier: Select a property to use as the lowest-level grouping for tradeable rows in the Rebalance dashboard.

For example, if you set the value to Instrument/Finbourne-Examples/AssetClass the Rebalance dashboard groups instruments (decorated with a value for the property) by asset class:

Note

If a portfolio group contains one or more portfolios with differing rebalance configuration mappings, the Rebalance dashboard disables the Equivalent security identifier grouping.

Tolerance rules

Configure absolute and model-relative tolerance values that trigger an auto-rebalance if exceeded. You can configure the rules to apply to:

• All holdings in the dashboard

• Holdings with a particular property

Rounding rules

Choose how LUSID should round your instrument lot sizes; see how to add lot sizes to instruments.

Absolute rules

For each rule, you can specify:

• An upper or lower limit for the amount in an order (in the portfolio currency)

• Which instruments to apply the order limit to

LUSID prioritises rules in the order you specify, for example rule 1 takes precedence over rule 4.

Cash rules

You can configure one or more cash rules to have LUSID warn you when you try to create an order that will bring your cash balance to below a certain amount or percentage.

Custom values

Order presets: Pre-populate each order in the order generation form with particular properties and values for the Type and Time in force fields. You can modify these values on-the-fly when necessary.

Rebalancing to your portfolio mapping models

To rebalance based on your portfolio mapping models, select the desired instruments and use the control panel to generate orders as usual. See how to use the Rebalance dashboard control panel.

See a full tutorial on how to add a portfolio mapping and run a cash equitisation rebalance, from start to finish.