Editors' picksPINE LIBRARYDataChart
Library "DataChart"
Library to plot scatterplot or heatmaps for your own set of data samples
draw(this)
draw contents of the chart object
Parameters:
this: Chart object
Returns: current chart object
init(this)
Initialize Chart object.
Parameters:
this: Chart object to be initialized
Returns: current chart object
addSample(this, sample, trigger)
Add sample data to chart using Sample object
Parameters:
this: Chart object
sample: Sample object containing sample x and y values to be plotted
trigger: Samples are added to chart only if trigger is set to true. Default value is true
Returns: current chart object
addSample(this, x, y, trigger)
Add sample data to chart using x and y values
Parameters:
this: Chart object
x: x value of sample data
y: y value of sample data
trigger: Samples are added to chart only if trigger is set to true. Default value is true
Returns: current chart object
addPriceSample(this, priceSampleData, config)
Add price sample data - special type of sample designed to measure price displacements of events
Parameters:
this: Chart object
priceSampleData: PriceSampleData object containing event driven displacement data of x and y
config: PriceSampleConfig object containing configurations for deriving x and y from priceSampleData
Returns: current chart object
Sample
Sample data for chart
Fields:
xValue: x value of the sample data
yValue: y value of the sample data
ChartProperties
Properties of plotting chart
Fields:
title: Title of the chart
suffix: Suffix for values. It can be used to reference 10X or 4% etc. Used only if format is not format.percent
matrixSize: size of the matrix used for plotting
chartType: Can be either scatterplot or heatmap. Default is scatterplot
outliersStart: Indicates the percentile of data to filter out from the starting point to get rid of outliers
outliersEnd: Indicates the percentile of data to filter out from the ending point to get rid of outliers.
backgroundColor
plotColor: color of plots on the chart. Default is color.yellow. Only used for scatterplot type
heatmapColor: color of heatmaps on the chart. Default is color.red. Only used for heatmap type
borderColor: border color of the chart table. Default is color.yellow.
plotSize: size of scatter plots. Default is size.large
format: data representation format in tooltips. Use mintick.percent if measuring any data in terms of percent. Else, use format.mintick
showCounters: display counters which shows totals on each quadrants. These are single cell tables at the corners displaying number of occurences on each quadrant.
showTitle: display title at the top center. Uses the title string set in the properties
counterBackground: background color of counter table cells. Default is color.teal
counterTextColor: text color of counter table cells. Default is color.white
counterTextSize: size of counter table cells. Default is size.large
titleBackground: background color of chart title. Default is color.maroon
titleTextColor: text color of the chart title. Default is color.white
titleTextSize: text size of the title cell. Default is size.large
addOutliersToBorder: If set, instead of removing the outliers, it will be added to the border cells.
useCommonScale: Use common scale for both x and y. If not selected, different scales are calculated based on range of x and y values from samples. Default is set to false.
plotchar: scatter plot character. Default is set to ascii bullet.
ChartDrawing
Chart drawing objects collection
Fields:
properties: ChartProperties object which determines the type and characteristics of chart being plotted
titleTable: table containing title of the chart.
mainTable: table containing plots or heatmaps.
quadrantTables: Array of tables containing counters of all 4 quandrants
Chart
Chart type which contains all the information of chart being plotted
Fields:
properties: ChartProperties object which determines the type and characteristics of chart being plotted
samples: Array of Sample objects collected over period of time for plotting on chart.
displacements: Array containing displacement values. Both x and y values
displacementX: Array containing only X displacement values.
displacementY: Array containing only Y displacement values.
drawing: ChartDrawing object which contains all the drawing elements
PriceSampleConfig
Configs used for adding specific type of samples called PriceSamples
Fields:
duration: impact duration for which price displacement samples are calculated.
useAtrReference: Default is true. If set to true, price is measured in terms of Atr. Else is measured in terms of percentage of price.
atrLength: atrLength to be used for measuring the price based on ATR. Used only if useAtrReference is set to true.
PriceSampleData
Special type of sample called price sample. Can be used instead of basic Sample type
Fields:
trigger: consider sample only if trigger is set to true. Default is true.
source: Price source. Default is close
highSource: High price source. Default is high
lowSource: Low price source. Default is low
tr: True range value. Default is ta.tr
Library to plot scatterplot or heatmaps for your own set of data samples
draw(this)
draw contents of the chart object
Parameters:
this: Chart object
Returns: current chart object
init(this)
Initialize Chart object.
Parameters:
this: Chart object to be initialized
Returns: current chart object
addSample(this, sample, trigger)
Add sample data to chart using Sample object
Parameters:
this: Chart object
sample: Sample object containing sample x and y values to be plotted
trigger: Samples are added to chart only if trigger is set to true. Default value is true
Returns: current chart object
addSample(this, x, y, trigger)
Add sample data to chart using x and y values
Parameters:
this: Chart object
x: x value of sample data
y: y value of sample data
trigger: Samples are added to chart only if trigger is set to true. Default value is true
Returns: current chart object
addPriceSample(this, priceSampleData, config)
Add price sample data - special type of sample designed to measure price displacements of events
Parameters:
this: Chart object
priceSampleData: PriceSampleData object containing event driven displacement data of x and y
config: PriceSampleConfig object containing configurations for deriving x and y from priceSampleData
Returns: current chart object
Sample
Sample data for chart
Fields:
xValue: x value of the sample data
yValue: y value of the sample data
ChartProperties
Properties of plotting chart
Fields:
title: Title of the chart
suffix: Suffix for values. It can be used to reference 10X or 4% etc. Used only if format is not format.percent
matrixSize: size of the matrix used for plotting
chartType: Can be either scatterplot or heatmap. Default is scatterplot
outliersStart: Indicates the percentile of data to filter out from the starting point to get rid of outliers
outliersEnd: Indicates the percentile of data to filter out from the ending point to get rid of outliers.
backgroundColor
plotColor: color of plots on the chart. Default is color.yellow. Only used for scatterplot type
heatmapColor: color of heatmaps on the chart. Default is color.red. Only used for heatmap type
borderColor: border color of the chart table. Default is color.yellow.
plotSize: size of scatter plots. Default is size.large
format: data representation format in tooltips. Use mintick.percent if measuring any data in terms of percent. Else, use format.mintick
showCounters: display counters which shows totals on each quadrants. These are single cell tables at the corners displaying number of occurences on each quadrant.
showTitle: display title at the top center. Uses the title string set in the properties
counterBackground: background color of counter table cells. Default is color.teal
counterTextColor: text color of counter table cells. Default is color.white
counterTextSize: size of counter table cells. Default is size.large
titleBackground: background color of chart title. Default is color.maroon
titleTextColor: text color of the chart title. Default is color.white
titleTextSize: text size of the title cell. Default is size.large
addOutliersToBorder: If set, instead of removing the outliers, it will be added to the border cells.
useCommonScale: Use common scale for both x and y. If not selected, different scales are calculated based on range of x and y values from samples. Default is set to false.
plotchar: scatter plot character. Default is set to ascii bullet.
ChartDrawing
Chart drawing objects collection
Fields:
properties: ChartProperties object which determines the type and characteristics of chart being plotted
titleTable: table containing title of the chart.
mainTable: table containing plots or heatmaps.
quadrantTables: Array of tables containing counters of all 4 quandrants
Chart
Chart type which contains all the information of chart being plotted
Fields:
properties: ChartProperties object which determines the type and characteristics of chart being plotted
samples: Array of Sample objects collected over period of time for plotting on chart.
displacements: Array containing displacement values. Both x and y values
displacementX: Array containing only X displacement values.
displacementY: Array containing only Y displacement values.
drawing: ChartDrawing object which contains all the drawing elements
PriceSampleConfig
Configs used for adding specific type of samples called PriceSamples
Fields:
duration: impact duration for which price displacement samples are calculated.
useAtrReference: Default is true. If set to true, price is measured in terms of Atr. Else is measured in terms of percentage of price.
atrLength: atrLength to be used for measuring the price based on ATR. Used only if useAtrReference is set to true.
PriceSampleData
Special type of sample called price sample. Can be used instead of basic Sample type
Fields:
trigger: consider sample only if trigger is set to true. Default is true.
source: Price source. Default is close
highSource: High price source. Default is high
lowSource: Low price source. Default is low
tr: True range value. Default is ta.tr
Pine library
In true TradingView spirit, the author has published this Pine code as an open-source library so that other Pine programmers from our community can reuse it. Cheers to the author! You may use this library privately or in other open-source publications, but reuse of this code in a publication is governed by House rules.
Trial - trendoscope.io/trial
Subscribe - trendoscope.io/pricing
Telegram: p.trendoscope.io/telegram
Rate us : trustpilot.com/review/trendoscope.io
Subscribe - trendoscope.io/pricing
Telegram: p.trendoscope.io/telegram
Rate us : trustpilot.com/review/trendoscope.io
Disclaimer
The information and publications are not meant to be, and do not constitute, financial, investment, trading, or other types of advice or recommendations supplied or endorsed by TradingView. Read more in the Terms of Use.