[dygraphs.git] / tests / independent-series.html

<!DOCTYPE html>
<html>
  <head>
    <title>Independent Series</title>
    <!--
    For production (minified) code, use:
    <script type="text/javascript" src="dygraph-combined.js"></script>
    -->
    <script type="text/javascript" src="../dygraph-dev.js"></script>

    <style type="text/css">
      .thinborder {
        border-width: 1px;
        border-spacing: 0px;
        border-style: solid;
        border-color: black;
        border-collapse: collapse;
      }

      .thinborder td,
      .thinborder th {
        border-width: 1px;
        padding: 5px;
        border-style: solid;
        border-color: black;
      }
    </style>
  </head>
  <body>
    <h3>Independent Series</h3>
    <p>By using the connectSeparated attribute, it's possible to display a chart of several time series with completely independent x-values.</p>

    <p>The trick is to specify values for the series at the union of the x-values of all series. For one series' x values, specify <code>null</code> for each of the other series.</p>

    <div id="graph" style="float: right; margin-right: 50px; width: 400px; height: 300px;"></div>
    <p>For example, say you had two series:</p>
    <table><tr>
    <td valign=top>
    <table>
      <table class=thinborder>
        <tr><th>x</th><th>A</th></tr>
        <tr><td>2</td><td>2</td></tr>
        <tr><td>4</td><td>6</td></tr>
        <tr><td>6</td><td>4</td></tr>
      </table>
    </td>
    <td valign=top style="padding-left:25px;">
      <table class=thinborder>
        <tr><th>x</th><th>B</th></tr>
        <tr><td>1</td><td>3</td></tr>
        <tr><td>3</td><td>7</td></tr>
        <tr><td>5</td><td>5</td></tr>
      </table>
    </td>
    </tr></table>

    <p>Then you would specify the following CSV or native data:</p>
    <table><tr>
    <td valign=top>
    (CSV)
    <pre>X,A,B
1,,3
2,2,
3,,7
4,6,
5,,5
6,4,</pre>
    </td>
    <td valign=top style="padding-left: 25px;">
    (native)
    <pre>[
[1, null, 3],
[2, 2, null],
[3, null, 7],
[4, 6, null],
[5, null, 5],
[6, 4, null] ]</pre>
    </td>
    </tr></table>

    <script type="text/javascript">
    var g1 = new Dygraph(
      document.getElementById("graph"),
      [
        [1, null, 3],
        [2, 2, null],
        [3, null, 7],
        [4, 5, null],
        [5, null, 5],
        [6, 3, null]
      ],
      {
        labels: ["x", "A", "B" ],
        connectSeparatedPoints: true,
        drawPoints: true
      }
    );
    </script>

    <h3>Encoding a gap</h3>
    <p>There's one extra wrinkle. What if one of the series has a missing
    value, i.e. what if your series are something like </p>

    <table><tr>
    <td valign=top>
    <table>
      <table class=thinborder>
        <tr><th>x</th><th>A</th></tr>
        <tr><td>2</td><td>2</td></tr>
        <tr><td>4</td><td>4</td></tr>
        <tr><td>6</td><td>(gap)</td></tr>
        <tr><td>8</td><td>8</td></tr>
        <tr><td>10</td><td>10</td></tr>
      </table>
    </td>
    <td valign=top style="padding-left:25px;">
      <table class=thinborder>
        <tr><th>x</th><th>B</th></tr>
        <tr><td>1</td><td>3</td></tr>
        <tr><td>3</td><td>5</td></tr>
        <tr><td>5</td><td>7</td></tr>
      </table>
    </td>
    </tr></table>

    <div id="graph3" style="float: right; margin-right: 50px; width: 400px; height: 300px;"></div>
    <p>The gap would normally be encoded as a null, or missing value. But when you use <code>connectSeparatedPoints</code>, that has a special meaning. Instead, you have to use <code>NaN</code>. This is a bit of a hack, but it gets the job done.</p> 

    <script type="text/javascript">
    g2 = new Dygraph(
      document.getElementById("graph3"),
"x,A,B  \n" +
"1,,3   \n" +
"2,2,   \n" +
"3,,5   \n" +
"4,4,   \n" +
"5,,7   \n" +
"6,NaN, \n" +
"8,8,   \n" +
"10,10, \n"
      , {
        connectSeparatedPoints: true,
        drawPoints: true
      }
    );
    </script>

    <table><tr>
    <td valign=top>
    (CSV)
    <pre>x,A,B
1,,3
2,2,
3,,5
4,4,
5,,7
6,NaN,
8,8,
10,10,</pre>
    </td>
    <td valign=top style="padding-left: 25px;">
    (native)
    <pre>[ [1, null, 3],
  [2, 2, null],
  [3, null, 5],
  [4, 4, null],
  [5, null, 7],
  [6, NaN, null],
  [8, 8, null],
  [10, 10, null] ]</pre>
    </td>
    </tr></table>

    <h3>Behavior at the edges of the panel for independent series</h3>
    <p> In case only a part of the whole data is visible (e.g. after zooming in) the lines are 
    drawn to the respective next valid point outside the visible area. </p>
              
    <table><tr>
    <td valign=top>
    <table>
      <table class=thinborder>
        <tr><th>x</th><th>A</th></tr>
        <tr><td>0</td><td>2</td></tr>
        <tr><td>1</td><td>3</td></tr>
        <tr><td>2</td><td>3</td></tr>
        <tr><td>4</td><td>4</td></tr>
        <tr><td>5</td><td>3</td></tr>
        <tr><td>6</td><td>3</td></tr>
        <tr><td>7</td><td>3</td></tr>
        <tr><td>8</td><td>4</td></tr>
      </table>
    </td>
    <td valign=top style="padding-left:25px;">
      <table class=thinborder>
        <tr><th>x</th><th>B</th></tr>
        <tr><td>0</td><td>1</td></tr>
        <tr><td>1</td><td>2</td></tr>
        <tr><td>2</td><td>1</td></tr>
        <tr><td>8</td><td>2</td></tr>
      </table>
    </td>
    </tr></table>

    <div id="graph2" style="float: right; margin-right: 50px; width: 400px; height: 300px;"></div>
    <p>Both graphs have no value at the right edge of the panel (x=3). The lines that are drawn to the right edge are determined by their respective next valid value outside the visible area.
    Therefore it is neither necessary that the next valid values are on the same point nor that they have the same index (index 4 for the green line and index 8 for the blue line).</p> 
    <p>Use double click to unzoom and see the currently invisible points</p> 
    
    <script type="text/javascript">
    g2 = new Dygraph(
      document.getElementById("graph2"),
"x,A,B  \n" +
"0,2,1   \n" +
"1,3,2   \n" +
"2,3,1   \n" +
"3,,   \n" +
"4,4,   \n" +
"5,3,   \n" +
"6,3,   \n" +
"7,3,   \n" +
"8,4,2   \n"

      , {
        connectSeparatedPoints: true,
        drawPoints: true,
        pointSize: 3,
        highlightCircleSize: 5,
        dateWindow: [0,3]
      }
    );
    </script>
    
    <table><tr>
    <td valign=top>
    Index
    <pre>&nbsp;
0
1
2
3
4
5
6
7
8</pre>
    </td>
    <td valign=top>
    (CSV)
    <pre>x,A,B
0,2,1
1,3,2
2,3,1
3,,
4,4,
5,3,
6,3,
7,3,
8,4,2</pre>
    </td>
    <td valign=top style="padding-left: 25px;">
    (native)
    <pre>[ 
  [0, 2, 1], 
  [1, 3, 2],
  [2, 3, 1],
  [3, null, null],
  [4, 4, null],
  [5, 3, null],
  [6, 3, null],
  [7, 3, null],
  [8, 4, 2] ]</pre>
    </td>
    </tr></table>

  </body>
</html>
Commit	Line	Data
	1	<!DOCTYPE html>
	2	<html>
	3	<head>
	4	<title>Independent Series</title>
	5	<!--
	6	For production (minified) code, use:
	7	<script type="text/javascript" src="dygraph-combined.js"></script>
	8	-->
	9	<script type="text/javascript" src="../dygraph-dev.js"></script>
	10
	11	<style type="text/css">
	12	.thinborder {
	13	border-width: 1px;
	14	border-spacing: 0px;
	15	border-style: solid;
	16	border-color: black;
	17	border-collapse: collapse;
	18	}
	19
	20	.thinborder td,
	21	.thinborder th {
	22	border-width: 1px;
	23	padding: 5px;
	24	border-style: solid;
	25	border-color: black;
	26	}
	27	</style>
	28	</head>
	29	<body>
	30	<h3>Independent Series</h3>
	31	<p>By using the connectSeparated attribute, it's possible to display a chart of several time series with completely independent x-values.</p>
	32
	33	<p>The trick is to specify values for the series at the union of the x-values of all series. For one series' x values, specify <code>null</code> for each of the other series.</p>
	34
	35	<div id="graph" style="float: right; margin-right: 50px; width: 400px; height: 300px;"></div>
	36	<p>For example, say you had two series:</p>
	37	<table><tr>
	38	<td valign=top>
	39	<table>
	40	<table class=thinborder>
	41	<tr><th>x</th><th>A</th></tr>
	42	<tr><td>2</td><td>2</td></tr>
	43	<tr><td>4</td><td>6</td></tr>
	44	<tr><td>6</td><td>4</td></tr>
	45	</table>
	46	</td>
	47	<td valign=top style="padding-left:25px;">
	48	<table class=thinborder>
	49	<tr><th>x</th><th>B</th></tr>
	50	<tr><td>1</td><td>3</td></tr>
	51	<tr><td>3</td><td>7</td></tr>
	52	<tr><td>5</td><td>5</td></tr>
	53	</table>
	54	</td>
	55	</tr></table>
	56
	57	<p>Then you would specify the following CSV or native data:</p>
	58	<table><tr>
	59	<td valign=top>
	60	(CSV)
	61	<pre>X,A,B
	62	1,,3
	63	2,2,
	64	3,,7
	65	4,6,
	66	5,,5
	67	6,4,</pre>
	68	</td>
	69	<td valign=top style="padding-left: 25px;">
	70	(native)
	71	<pre>[
	72	[1, null, 3],
	73	[2, 2, null],
	74	[3, null, 7],
	75	[4, 6, null],
	76	[5, null, 5],
	77	[6, 4, null] ]</pre>
	78	</td>
	79	</tr></table>
	80
	81	<script type="text/javascript">
	82	var g1 = new Dygraph(
	83	document.getElementById("graph"),
	84	[
	85	[1, null, 3],
	86	[2, 2, null],
	87	[3, null, 7],
	88	[4, 5, null],
	89	[5, null, 5],
	90	[6, 3, null]
	91	],
	92	{
	93	labels: ["x", "A", "B" ],
	94	connectSeparatedPoints: true,
	95	drawPoints: true
	96	}
	97	);
	98	</script>
	99
	100	<h3>Encoding a gap</h3>
	101	<p>There's one extra wrinkle. What if one of the series has a missing
	102	value, i.e. what if your series are something like </p>
	103
	104	<table><tr>
	105	<td valign=top>
	106	<table>
	107	<table class=thinborder>
	108	<tr><th>x</th><th>A</th></tr>
	109	<tr><td>2</td><td>2</td></tr>
	110	<tr><td>4</td><td>4</td></tr>
	111	<tr><td>6</td><td>(gap)</td></tr>
	112	<tr><td>8</td><td>8</td></tr>
	113	<tr><td>10</td><td>10</td></tr>
	114	</table>
	115	</td>
	116	<td valign=top style="padding-left:25px;">
	117	<table class=thinborder>
	118	<tr><th>x</th><th>B</th></tr>
	119	<tr><td>1</td><td>3</td></tr>
	120	<tr><td>3</td><td>5</td></tr>
	121	<tr><td>5</td><td>7</td></tr>
	122	</table>
	123	</td>
	124	</tr></table>
	125
	126	<div id="graph3" style="float: right; margin-right: 50px; width: 400px; height: 300px;"></div>
	127	<p>The gap would normally be encoded as a null, or missing value. But when you use <code>connectSeparatedPoints</code>, that has a special meaning. Instead, you have to use <code>NaN</code>. This is a bit of a hack, but it gets the job done.</p>
	128
	129	<script type="text/javascript">
	130	g2 = new Dygraph(
	131	document.getElementById("graph3"),
	132	"x,A,B \n" +
	133	"1,,3 \n" +
	134	"2,2, \n" +
	135	"3,,5 \n" +
	136	"4,4, \n" +
	137	"5,,7 \n" +
	138	"6,NaN, \n" +
	139	"8,8, \n" +
	140	"10,10, \n"
	141	, {
	142	connectSeparatedPoints: true,
	143	drawPoints: true
	144	}
	145	);
	146	</script>
	147
	148	<table><tr>
	149	<td valign=top>
	150	(CSV)
	151	<pre>x,A,B
	152	1,,3
	153	2,2,
	154	3,,5
	155	4,4,
	156	5,,7
	157	6,NaN,
	158	8,8,
	159	10,10,</pre>
	160	</td>
	161	<td valign=top style="padding-left: 25px;">
	162	(native)
	163	<pre>[ [1, null, 3],
	164	[2, 2, null],
	165	[3, null, 5],
	166	[4, 4, null],
	167	[5, null, 7],
	168	[6, NaN, null],
	169	[8, 8, null],
	170	[10, 10, null] ]</pre>
	171	</td>
	172	</tr></table>
	173
	174	<h3>Behavior at the edges of the panel for independent series</h3>
	175	<p> In case only a part of the whole data is visible (e.g. after zooming in) the lines are
	176	drawn to the respective next valid point outside the visible area. </p>
	177
	178	<table><tr>
	179	<td valign=top>
	180	<table>
	181	<table class=thinborder>
	182	<tr><th>x</th><th>A</th></tr>
	183	<tr><td>0</td><td>2</td></tr>
	184	<tr><td>1</td><td>3</td></tr>
	185	<tr><td>2</td><td>3</td></tr>
	186	<tr><td>4</td><td>4</td></tr>
	187	<tr><td>5</td><td>3</td></tr>
	188	<tr><td>6</td><td>3</td></tr>
	189	<tr><td>7</td><td>3</td></tr>
	190	<tr><td>8</td><td>4</td></tr>
	191	</table>
	192	</td>
	193	<td valign=top style="padding-left:25px;">
	194	<table class=thinborder>
	195	<tr><th>x</th><th>B</th></tr>
	196	<tr><td>0</td><td>1</td></tr>
	197	<tr><td>1</td><td>2</td></tr>
	198	<tr><td>2</td><td>1</td></tr>
	199	<tr><td>8</td><td>2</td></tr>
	200	</table>
	201	</td>
	202	</tr></table>
	203
	204	<div id="graph2" style="float: right; margin-right: 50px; width: 400px; height: 300px;"></div>
	205	<p>Both graphs have no value at the right edge of the panel (x=3). The lines that are drawn to the right edge are determined by their respective next valid value outside the visible area.
	206	Therefore it is neither necessary that the next valid values are on the same point nor that they have the same index (index 4 for the green line and index 8 for the blue line).</p>
	207	<p>Use double click to unzoom and see the currently invisible points</p>
	208
	209	<script type="text/javascript">
	210	g2 = new Dygraph(
	211	document.getElementById("graph2"),
	212	"x,A,B \n" +
	213	"0,2,1 \n" +
	214	"1,3,2 \n" +
	215	"2,3,1 \n" +
	216	"3,, \n" +
	217	"4,4, \n" +
	218	"5,3, \n" +
	219	"6,3, \n" +
	220	"7,3, \n" +
	221	"8,4,2 \n"
	222
	223	, {
	224	connectSeparatedPoints: true,
	225	drawPoints: true,
	226	pointSize: 3,
	227	highlightCircleSize: 5,
	228	dateWindow: [0,3]
	229	}
	230	);
	231	</script>
	232
	233	<table><tr>
	234	<td valign=top>
	235	Index
	236	<pre>
	237	0
	238	1
	239	2
	240	3
	241	4
	242	5
	243	6
	244	7
	245	8</pre>
	246	</td>
	247	<td valign=top>
	248	(CSV)
	249	<pre>x,A,B
	250	0,2,1
	251	1,3,2
	252	2,3,1
	253	3,,
	254	4,4,
	255	5,3,
	256	6,3,
	257	7,3,
	258	8,4,2</pre>
	259	</td>
	260	<td valign=top style="padding-left: 25px;">
	261	(native)
	262	<pre>[
	263	[0, 2, 1],
	264	[1, 3, 2],
	265	[2, 3, 1],
	266	[3, null, null],
	267	[4, 4, null],
	268	[5, 3, null],
	269	[6, 3, null],
	270	[7, 3, null],
	271	[8, 4, 2] ]</pre>
	272	</td>
	273	</tr></table>
	274
	275	</body>
	276	</html>