Skip to content

Latest commit

 

History

History
87 lines (69 loc) · 2.57 KB

README.md

File metadata and controls

87 lines (69 loc) · 2.57 KB

Graphika 📈 📊

basic chart Lightning fast, robust library to draw graphs and charts in the browser. The current version supports drawing graphs with positive and negative scales. It also enables the user to add custom labels and titles to the graphs. More coming in the future.

Documentation

Documentation is split into separate files regarding each sub-system of the drawing library.

  • Read about customising title options go here.
  • Read about customising grid options go here.
  • Read about customising line options go here.
  • Read about customising legend options, go here.

Getting started

To create a new graph you must import the minified or combined version into the html document by adding this line in the <body> or <head> tag. Insert this script tag into the html document:

<script src="js/graphika/dist/graph.min.js">

To create a new graph you must initialise a graph object by providing it a <div> element id, where the graph object should insert the given tittle and canvas (if no canvas exists within the element). To this, simply create a new variable and associate a 'new' graph object like so:

<div id="graph">
    <canvas width="800" height="600"></canvas>
</div>

Add some javascript:

// some data, use a function to load it, fetch it, read csv
const dataset = [
  0: [...],
  1: [...]
];

// where `graph` is the given id of the div you wish for the graph to use
const graph = new Graph.Graph(
    "graph",
    {
        title: {
            content: "Graphika!",
        },
        x_label: "X-Axis",
        y_label: "Y-Axis",
    },
    [
        {
            style: "dashed",
            label: "line-1",
            interpolation: "cubic",
            data: dataset[0],
            annotatePoints: false,
            colour: Graph.Colours.PURPLE,
            area: {
                fill: true,
                colour: Graph.Colours.PURPLE,
            },
        },
        {
            label: "line-2",
            interpolation: "cubic",
            data: dataset[1],
            colour: Graph.Colours.EMERALD_GREEN,
            annotatePoints: true,
            area: {
                fill: true,
                colour: Graph.Colours.EMERALD_GREEN,
            },
        },
    ]
);

graph.draw(); // let's draw the graph

Result: basic chart

Examples

Check out examples of graphs in the examples directory.