Gtl.plot.add axis

Краткое описание

Функция предназначена для добавления и управления свойствами осей Y на координатной плоскости. Используется в тех случаях когда необходимо разделить оси Y разных графиков, расположенных на одной координатной плоскости.

Объявление функции

Для создания координатной плоскости (вкладки) используется запись (https://docs.gtlab.pro/index.php/Gtl.plot.add):

let plot1 = gtl.plots.add( Наименование плоскости );

Для добавления новой оси на координатную плоскость используется метод add_axis:

let axis2 = plot1.add_axis(
  {
    title: "squares",
    min: 0,
    max: 1
  }
);

Свойства (методы)

title = "squares"; - наименование оси Y;

min = 0; - минимальное значение по оси Y;

max = 1; - максимальное значение по оси Y;

Обращение к свойствам осей происходит через их индекс посредством метода axis_at( index ):

plot1.axis_at(0).title = "triangles"; //изменение наименования
plot1.axis_at(0).min = -5; //изменение минимального значения по оси
plot1.axis_at(0).max = 5; //изменение максимального значения по оси

Пример использования

//управление осями на координатной плоскости
let plot1 = gtl.plots.add("plot1"); //создаем координатную плоскость 1

//обращаемся к свойствам первой оси Y на координатной плоскости 1
plot1.axis_at(0).title = "triangles"; //наименование оси Y
plot1.axis_at(0).min = -5; //минимальное значение по оси Y
plot1.axis_at(0).max = 5; //максимальное значение по оси Y

let values1 = []; //набор данных для графика 1
let values2 = []; //набор данных для графика 2 
for (i = 0; i < 10; i++) {
  values1.push(Math.random());
  values2.push(Math.random());
} //формируем случайный набор данных для графиков

function diagnose() {
  plot1.add(
    {
      color: 0x0000ff, //цвет графика 1
      name: "series1", //наименование графика 1
      x: 1.0, //значение по оси X
      y: values1, //значения по оси Y
      point: {
        type: gtl.series.triangle,
        size: 10
      }, //маркеры 

      tags: ["triangles", "blue"] //набор тэгов (идентификаторов) графика 1
    }
  )

  plot1.add(
    {
      color: 0x007f00, //цвет графика 2
      name: "series2", //наименование графика 2
      x: 2.0, //значение по оси X
      y: values2, //значения по оси Y
      point: {
        type: gtl.series.square,
        size: 10
      }, //маркеры

      tags: ["squares", "green"] //набор тэгов (идентификаторов) графика 2
    }
  )

  //добавляем отдельную ось для графика 2 на общей координатной плоскости 1
  let axis2 = plot1.add_axis(
    {
      title: "squares", //наименование оси
      min: 0, //минимальное значение по оси Y
      max: 1 //максимальное значение по оси Y
    }
  );

  gtl.diagnostic.stop();
}