Secondary Timeframe & Instruments

Users can add a secondary bars series by calling the AddBars method. The AddBars method can be only called when the script is in Initialze state. ArthaChitra provides multiple overloads on how the new bars will be configured. Please click here to see the available overloads.

The AddBars method has a number of overloads and presents a very flexible environment on how the secondary bars will be configured. Please find below the different parameters available.

Instrument	The string representation of the instrument. The string should formatted as mentioned in the section 'Instrument Name format' here.
BarType	BarType of the bars
Start Date	Start date of the bars
End Date	End date of the bars
Session	Session for the bars
Is Continuous	If the bars series is continuous or not. Valid for futures instrument only.

If any parameter is not specifically defined then that parameter will be referenced from the primary bars series. For example if the user only defines the barType then the instrument, startDate, endDate etc will be referenced from the primary bars series.

Example

protected override void OnStateChange()
{
    if (base.State == State.Initialize)
    {
        //add a 5 minute time frame of the primary instrument
        AddBars(new Minute(5));    

        //adds a 3 minute bars of Reliance
        AddBars("RELIANCE NSE", new Minute(3));

        //add a secondary bars of 150 Ticks
        AddBars(new Tick(150));

        //add a daily bars series
        AddBars("RELIANCE NSE", new Minute(5), "NSE", DateTime.Today.AddDays(-365), DateTime.Now, IO.BackfillPolicy.Default);
    }
}

The bars data is referenced based on the time stamp of the bar. To illustrate, say the primary bars series is a 1 Minute bars and an additional bars series of say, 5 minute bars series has been added. In such scenario, ArthaChitra will first process the 1 minute bars till a 5 minute bars forms.

SharpScript exposes a host of properties which lets users to retrieve the values of secondary bars series. Below please find the popular properties pertaining to secondary series.

BarsInProgress

BarsInProgress returns the bars index for which the OnBarUpdate method is getting processed. It is important to remember that the Time, Price & volume series properties, like Time, High or Volume etc will return the values for the bars series which is currently getting processed. The below code further illustrates it.

Example

if (BarsInProgress == 1)
{
    //Since bars in progress is 1 Close will get the value of the secondary series close
    double currentBarsIndexClose = Close[0];
    //To get the close value of the primary series when BarsInProgress is 1 please refer to the below code
    double primaryBarsIndexClose = Closes[0][0];
}

CurrentBars

The currentBars property is an array of the available CurrentBar property. User should always check if sufficient bars are available before calling any value from any price series or otherwise.

Example

if (CurrentBars[0][0] < 0 || CurrentBars[1][0] < 0)
    return;

Time, Price and Volume series

ArthaChitra have a host of arrays which exposes the time, price and volumes values. Some of the properties ArthaChitra exposes are Times, Opens, Highs, Lows, Closes, Medians, Typicals, Weighteds, Volumes, OpenInterests

Example

//Gets the primary bars close
double primaryBarsIndexClose = Closes[0][0];
//gets the High of first secondary series
double secClose = Highs[1][0];

BarsArray

The BarsArray property returns an array of all available Bars.

Strategy properties

Positions

Positions property returns the positions available in the strategy.

Secondary bars series can be used as an Input in a referenced Indicator. This is useful if user wants to calculate the values of the indicator based on a different timeframe etc.

For example, if user has a secondary bars series of say, a 1 Minute bars and want to calculate the Simple Moving Average based on that bars series then he can simply call

Example

//calculate 14 period sma based on the first secondary series
SMA secondarySma = AddOrGetIndicator<SMA>(this, this.BarsArray[1], 14);

double smaValue = secondarySma[0];

Note : The [P:ArthaChitra.Model.SharpScript.Series`T] is binded with the primary bar only. As such user may witness different behavior on how the plots are rendered in historical data and realtime data.