Files
Superalgos/docs/pages/suite/suite-references.md
T
Julian Molina c2fb254a04 New documentation
First commit, halfway through a major restructuring of documentation.
2020-02-01 11:25:36 +01:00

3.4 KiB

title, summary, sidebar, permalink
title summary sidebar permalink
References References enable nodes to acquire information and properties from other nodes. suite_sidebar suite-references.html

{{site.data.concepts.reference}}

As such, references have a direction property relative to each of the nodes involved in the reference: the node establishing the reference sets an outgoing reference, while the one accepting the reference sets an incoming reference.

For example, a session (testing or live) establishes an outgoing reference with a trading system. This allows the session to access the information within the whole trading system hierarchy, including strategies. At the trading system level, the same reference is viewed as an incoming reference.

Sessions-03-Link-Session

A reference established between nodes of any particular structure within a hierarchy is said to be an internal reference relative to the said structure of nodes. Similarly, a reference established with a node outside of the said structure, that is, in a different part of the hierarchy or in another hierarchy, is said to be an external reference.

Examples of internal references may be found in the Data Mine and Crypto Ecosystem hierarchies. For example, let's briefly look into one such case within a plotter module:

The capture below shows the shapes node and several offspring objects: on one hand, several polygons; on the other hand, the chart points node.

Backups-04-Internal-references-intro-shapes

Notice that vertices under each polygon reference to points under the chart points node.

This means that the node shapes feature several internal references.

The backup, clone and share operations described later in this section make different uses of the properties of references. We will cover the three of them extensively so that you may make the most of these features.

Establishing and Removing References

To establish a reference, right-click on the first node and drag it close to the target node. Grey rings show which nodes you may establish a reference with. In case there are multiple nodes that would accept the reference, the one closer to the node where the reference originates will have its ring highlighted. Releasing the mouse button establishes the reference, or links both nodes.

{% include note.html content="The reference is visually represented by a faint grey dotted line. Such line is visible only when both ends of the reference are visible." %}

Throughout this documentation we may use the verb "to link interchangeably with to establish a reference, as synonyms.

To remove a reference or delink two nodes, simply right-click the node where the reference originates and make a dentle swipping motion away from the target node.

Link-01-link-and-delink