... is an AngularJS component wrapper for the Epoch. The creation of this set of components stemmed from the need for a simple set of charts where each chart could have data fed to it via AngularJS. I first looked for a decent charting module for Angular and couldn't find one that satisfied the client needs. That's when I stumbled upon Epoch.
First, it should be obvious that ng-epoch will depend on Epoch and any of its dependencies. Keep this in mind should you choose to install manually. Please read the installation instructions on the Epoch project site for further help. Other than that, ng-epoch only requires AngularJS 1.5+.
bower install ng-epochThis will download the latest version of ng-epoch and it's dependencies into your project. Those dependencies are:
Important: When including the libraries in your page, ensure that D3 is loaded before Epoch.
Visit each of the project sites listed above and download their packages and put them into your project directory. Then proceed to the Preparation steps below.
If you can locate CDN sources for each of the above listed libraries, and you prefer CDN distributions, then identify the URLs for the libraries you can, download the source packages you can't find CDNs for applying the Old Skool method above, and finally proceed to the Preparation steps below.
In the head of your page, include the base stylesheet. Instructions for customizing chart styles is available on the Epoch Project Site.
<link rel="stylesheet" href="https://github.com/dainbrump/ng-epoch/blob/master/[PATH_TO_BOWER_COMPNENTS]/epoch/epoch.min.css" />Then, where you load your javascript sources, add the following sources.
If you do not already have jQuery and AngularJS included:
<script src="https://github.com/dainbrump/ng-epoch/raw/master/[PATH_TO_BOWER_COMPNENTS]/jquery/dist/jquery.min.js"></script>
<script src="https://github.com/dainbrump/ng-epoch/raw/master/[PATH_TO_BOWER_COMPNENTS]/angular/angular.min.js"></script>After you load those two libraries, include:
<script src="https://github.com/dainbrump/ng-epoch/raw/master/[PATH_TO_BOWER_COMPNENTS]/d3/d3.min.js"></script>
<script src="https://github.com/dainbrump/ng-epoch/raw/master/[PATH_TO_BOWER_COMPNENTS]/epoch/epoch.min.js"></script>
<script src="https://github.com/dainbrump/ng-epoch/raw/master/[PATH_TO_BOWER_COMPNENTS]/ng-epoch/ng-epoch.js"></script>To ensure proper functionality, make sure that the sources are loaded in this general order.
Now for the fun part... create a chart. You should be able to get all the info you need from the docs page. The docs are slated for an update real soon. For further details I will refer you to the testpage.html under the example directory and say "Good luck. Kirk, out."
I claim no copyright for any of the supporting libraries. Please refer to their copyright notices for usage and restrictions. Ng-epoch is released under the MIT license.
The MIT License (MIT)
Copyright (c) 2016 Mark Litchfield.
Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.