deimosaffair

Back to zero: Understanding series

type: pine series basic example
time required: 10 minutes
level: medium (need to know the "array" data variable as a generic programming concept, basic Pine syntax)

tl; dr             how variables and series work in Pine

Pine is an array/vector language. That's something that twists how it behaves, and how we have to think about it. A lot of misunderstandings come from forgetting this fact. This example tries to clear that concept.

First, you need to know what an array is, and how it works in a programmig language. Also, having javascript under your belt helps too. If you don't, google             "javascript array basic tutorial" is your friend :)

So, in pine arrays are called "series". Every variable is an array with values for each candle in the chart. if we do:

myVar = true


this is not a constant. It is a series of values for each candle, { true, true,....., true }
In practice, the result is the same, but we can access each of the values in the series, like myVar{0}, myVar{7}, myVar{anyNumber}....
Again, it is not a constant, since you can access/modify the each value individually

so, lets show it:
plot (myVar, clolor = gray)

this plots an horizontal line of value 1 ( 1 is equal to true ) so it's all good.

On to a more usual series:

tipicalSeries = close > open ? true : false
plot(tipicalSeries, color= blue)


This gives the expected result, a tipical up and down line with values at 1 or 0. Naturally, "tipicalSeries" is an array, the "ups" and "downs" are all stored under the same variable, indexed by the candles.
In Pine, the ZERO position in the array is the last one, which corresponds to the last candle on the right. Say you have a chart with 12 candles. The close would be the closing value of what we intuitively think as first candle, the one on the left. then close... and so on.... until close, the value of the "last" candle, the one on the right. It actually helps to start thinking of the positions backwards, counting down to zero, rocket launch style :)

And back to our series. The myVar will also be the same size, from myVar to myVar.

When we do some operation with them, something simple like
if ( myVar == tipicalSeries)
what is really happening is that internally, Pine is checking each of the indexes, as in myVar == tipicalSeries , myVar == tipicalSeries .... myVar == tipicalSeries
And we can store that stuff to check it. simply:
result = (myVar == tipicalSeries) ? true : false //yes, this is the same as tipicalSeries, but we're not in a boolean logic tut ;)
plot (result)


The reason we can plot the result is that it is an array, not a single value. The example indicator i provide shows a plot where the values are obtained from different places in the array, this line here:

mySeries3 = mySeries2 and mySeries1

this creates a series that is the result of the PREVIOUS values stored (the zero index is the one most at the right, or the "current" one), which here just causes a shift in the plotted line by one candle.

Go ahead, grab a copy of my code, try to change the indexes and see the results. Understanding this stuff is critical to go deeper into Pine :)
Remove from Favorite Scripts Add to Favorite Scripts
EDIT: it appears the square bracket '[' is a special char in the text, so i had to change to '{' and '}'.
So, in you mind please change the {}'s for "those damn square brackets i cannot use" :)
Reply
testing... myvar myvar myvar\

Reply
deimosaffair deimosaffair
ok, so square brakets just cannot be used in any way, either in main text or in comments. nice ..... ;P

there are a lot of missing pieces in my text, wich changes it's sense upside down. where you see myvar in the main text, you should see myvar{somenumber}. and, not with curly brakets, but with square brakets. just look at the code, it's the most clear, simple, best example of it all :)
Reply
Thanks deimosaffair !!!
Reply
Ideas Scripts Chart
United States
United Kingdom
India
España
France
Italia
Brasil
Россия
Türkiye
日本
한국
Home Stock Screener Forex Signal Finder Economic Calendar How It Works Chart Features House Rules Moderators For the WEB Widgets Stock Charting Library Priority Support Feature Request Blog & News FAQ Help & Wiki Twitter
Private Messages Chat Ideas Published Followers Following Priority Support Public Profile Profile Settings Account and Billing Sign Out