Data-Forge

The JavaScript data transformation and analysis toolkit inspired by Pandas ...

JSON

data-forge/data-forge-ts www.data-forge-js.com/data-forge

README

Data-Forge

The JavaScript data transformation and analysis toolkit inspired by Pandas and LINQ.

*Implemented* in TypeScript.

Used in JavaScript ES5+ or TypeScript.

To learn more about Data-Forge visit the home page.

Read about Data-Forge for data science in the book JavaScript for Data Science.

Love this? Please star this repo and click here to support my work

Please note that this TypeScript repository replaces the previous JavaScript version of Data-Forge.

BREAKING CHANGES

As of v1.6.9 the dependencies Sugar, Lodash and Moment have been factored out (or replaced with smaller dependencies). This more than halves the bundle size. Hopefully this won't cause any problems - but please log an issue if something changes that you weren't expecting.

As of v1.3.0 file system support has been removed from the Data-Forge core API. This is after repeated issues from users trying to get Data-Forge working in the browser, especially under AngularJS 6.

Functions for reading and writing files have been moved to the separate code library Data-Forge FS.

If you are using the file read and write functions prior to 1.3.0 then your code will no longer work when you upgrade to 1.3.0. The fix is simple though, where usually you would just require in Data-Forge as follows:

``` js
const dataForge = require('data-forge');
```

Now you must also require in the new library as well:

``` js
const dataForge = require('data-forge');
require('data-forge-fs');
```

Data-Forge FS augments Data-Forge core so that you can use the readFile/writeFile functions as in previous versions and as is shown in this readme and the guide.

If you still have problems with AngularJS 6 please see this workaround:

https://github.com/data-forge/data-forge-ts/issues/3#issuecomment-438580174

Install

To install for Node.js and the browser:

npm install --save data-forge

If working in Node.js and you want the functions to read and write data files:

npm install --save data-forge-fs

Quick start

Data-Forge can load CSV, JSON or arbitrary data sets.

Parse the data, filter it, transform it, aggregate it, sort it and much more.

Use the data however you want or export it to CSV or JSON.

Here's an example:

``` js
const dataForge = require('data-forge');
require('data-forge-fs'); // For readFile/writeFile.
dataForge.readFileSync('./input-data-file.csv') // Read CSV file (or JSON!)
.parseCSV()
.parseDates(["Column B"]) // Parse date columns.
.parseInts(["Column B", "Column C"]) // Parse integer columns.
.parseFloats(["Column D", "Column E"]) // Parse float columns.
.dropSeries(["Column F"]) // Drop certain columns.
.where(row => predicate(row)) // Filter rows.
.select(row => transform(row)) // Transform the data.
.asCSV()
.writeFileSync("./output-data-file.csv"); // Write to output CSV file (or JSON!)
```

From the browser

Data-Forge has been tested with Browserify and Webpack. Please see links to examples below.

If you aren't using Browserify or Webpack, the npm package includes a pre-packed browser distribution that you can install and included in your HTML as follows: