Aframe-babia-components

Data visualization components for A-Frame.

Why

This pack of components has the aim of visualize data in several ways. There are separated components and each one has an independent aim:

geo* visualize the data prepared by a vismapper in several ways (this type of components must have in the same entity than a vismapper)
querier_* the aim of just query data and save it in the entity that it has
filterdata filter the data saved by one of the queriers
vismapper map the data filtered by filterdata to geometry attributes of the different charts, it "prepares" the data and save it in the entity that it has.

For instance:

<a-entity geo3dbarchart='legend: true; 
    data:"[{"key":"David","key2":"2019","size":9},{"key":"David","key2":"2018","size":8},{"key":"David","key2":"2017","size":7},{"key":"David","key2":"2016","size":6},{"key":"David","key2":"2015","size":5},{"key":"Pete","key2":"2011","size":8},{"key":"Pete","key2":"2014","size":7},{"key":"Josh","key2":"2016","size":6},{"key":"Josh","key2":"2015","size":5},{"key":"Jesus","key2":"2016","size":9},{"key":"Jesus","key2":"2011","size":8},{"key":"Jesus","key2":"2014","size":7},{"key":"Jesus","key2":"2016","size":6},{"key":"Jesus","key2":"2015","size":5},{"key":"Jesus","key2":"2016","size":9},{"key":"Steve","key2":"2016","size":9},{"key":"Steve","key2":"2017","size":8},{"key":"Steve","key2":"2014","size":7},{"key":"Steve","key2":"2013","size":6},{"key":"Moreno","key2":"2015","size":5},{"key":"Jesus","key2":"2019","size":10},{"key":"Pete","key2":"2019","size":10}]"' 
position="-10 0 0" rotation="0 0 0"></a-entity>

or using the querier/filters/mappers components (see HOW_TO_CHARTS_WITH_QUERIER.md)

<a-entity id="queriertest" querier_json="url: ./data.json;"></a-entity>
<a-entity geo3dbarchart='legend: true' filterdata="from: queriertest"
            vismapper="x_axis: name; z_axis: age; height: size" position="-10 0 0" rotation="0 0 0"></a-entity>

Usage

Browser Installation

Install and use by directly including the browser files:

<!DOCTYPE html>
<html>

<head>
    <meta charset="utf-8">
    <title>A-Frame Babia components</title>
    <script src="https://aframe.io/releases/0.9.2/aframe.min.js"></script>
    <script src="https://unpkg.com/aframe-babia-components/dist/aframe-babia-components.min.js"></script>
</head>

<body>

    <a-scene background="color: #A8F3FF" id="AframeScene">
        
        <a-entity geo3dbarchart='legend: true; 
            data:"[{"key":"David","key2":"2019","size":9},{"key":"David","key2":"2018","size":8},{"key":"David","key2":"2017","size":7},{"key":"David","key2":"2016","size":6},{"key":"David","key2":"2015","size":5},{"key":"Pete","key2":"2011","size":8},{"key":"Pete","key2":"2014","size":7},{"key":"Josh","key2":"2016","size":6},{"key":"Josh","key2":"2015","size":5},{"key":"Jesus","key2":"2016","size":9},{"key":"Jesus","key2":"2011","size":8},{"key":"Jesus","key2":"2014","size":7},{"key":"Jesus","key2":"2016","size":6},{"key":"Jesus","key2":"2015","size":5},{"key":"Jesus","key2":"2016","size":9},{"key":"Steve","key2":"2016","size":9},{"key":"Steve","key2":"2017","size":8},{"key":"Steve","key2":"2014","size":7},{"key":"Steve","key2":"2013","size":6},{"key":"Moreno","key2":"2015","size":5},{"key":"Jesus","key2":"2019","size":10},{"key":"Pete","key2":"2019","size":10}]"' 
        position="-10 0 0" rotation="0 0 0"></a-entity>

        <a-entity camera position="0 0 0" look-controls></a-entity>
        
    </a-scene>
</body>

NPM Installation

Install via NPM:

npm i aframe-babia-components

Then require and use.

require('aframe');
require('aframe-babia-components');

// or

import 'aframe'
import 'aframe-babia-components'

How to use this components

The basic Chart components are easy to use, they have few attributes but if you want to see all the components and how to use them, there are user guides in the docs folder, here are the links:

HOW_TO_CHARTS_WITH_QUERIER.md: a simple user guide in order to learn how to create charts with this pack of components.

Chart components API

The installation contains the following components:

geopiechart component

This component must be used with one of the vismapper components, with the slice and height attribute defined.

This component shows a pie chart.

API

Property	Description	Type	Default value
legend	Shows a legend when hovering a slice	boolean	false
axis	Shows chart axis	boolean	true
data	Data to show with the chart	JSON (list of objects)	-

Data format

[{"key":"kbn_network","size":10},
{"key":"Maria","size":5},
...
]

geosimplebarchart component

This component must be used with one of the vismapper components, with the x-axis and height attribute defined.

This component shows a simple 2D bar chart.

API

Property	Description	Type	Default value
legend	Shows a legend when hovering a bar	boolean	false
axis	Shows chart axis	boolean	true
data	Data to show with the chart	JSON (list of objects)	-

Data format

[{"key":"kbn_network","size":10},
{"key":"Maria","size":5},
...
]

geo3dbarchart component

This component must be used with one of the vismapper components, with the x-axis, z-axis and height attribute defined.

This component shows a 3D bar chart.

API

Property	Description	Type	Default value
legend	Shows a legend when hovering a bar	boolean	false
axis	Shows chart axis	boolean	true
data	Data to show with the chart	JSON (list of objects)	-

Data format

[{"key":"David","key2":"2019","size":9},
{"key":"David","key2":"2018","size":8},
...
]

bubblechart component

This component must be used with one of the vismapper components, with the x-axis, z-axis, radius and height attribute defined.

This component shows a 3D bar chart.

API

Property	Description	Type	Default value
legend	Shows a legend when hovering a bubble	boolean	false
axis	Shows chart axis	boolean	true
data	Data to show with the chart	JSON (list of objects)	-

Data format

[{"key":"David","key2":"2019","height":1,"radius":9},
{"key":"David","key2":"2018","height":2,"radius":8},
...
]

Querier/Filter/Mapper and other components API

querier_json component

Component that will retrieve data from a JSON input that can be defined as an url or directly embedded.

This component will put the data retrieved into the baratariaData attribute of the entity.

API

Property	Description	Type	Default value
url	Url of the file with the JSON data	string	-
embedded	JSON data directly stringified in the property	string	-

querier_github component

Component that will retrieve data related to the repositories from an user using the GitHub API. It can be defined the username in order to get info about all the repositories or also it can be defined an array of repos in order to analyse just them (instead of all).

This component will put the data retrieved into the baratariaData attribute of the entity.

API

Property	Description	Type	Default value
user	GitHub username	string	-
repos	List of repo that you want to analyse	array	(If empty it will retrieve all the repos of the user)

filterdata component

This component must be used with one of the querier components. This component will select a part of the data retrieved (by a key/filter) in order to represent just that part of the data. If the filter is not defined, it will retrieve all the data. This component will put the data selected into the baratariaData attribute of the entity.

API

Property	Description	Type	Default value
from	Id of one of the querier components	string	-
filter (Optional)	Key of the item that you want to analyse, this key must be in the data retrieved from a querier. Work in progress: in the next future it will have more filter	string	-

vismapper component

This component map the data selected by the filterdata component into a chart component or physical properties of a geometry component.

This component must be in the same entity than filterdata and it needs also a chart component or geometry.

API

Property	Description	Type	Default value
height	Field of the data selected by filterdata that will be mapped as the height of the items of the charts or a geometry. Valid for geo3dbarchart, geobubbleschart, geosimplebarchart and box/sphere	string	-
radius	Field of the data selected by filterdata that will be mapped as the radius of the items of the charts or a geometry. Valid for geobubbleschart and sphere	string	-
slice	Field of the data selected by filterdata that will be mapped as the slices of the items of a pie chart. Valid for piehchart	string	-
z-axis	Field of the data selected by filterdata that will be mapped as the keys of the Z Axis of the chart component selected. Valid for geo3dbarchart and bubblechart	string	-
x-axis	Field of the data selected by filterdata that will be mapped as the keys of the X Axis of the chart component selected. Valid for geo3dbarchart, bubblechart and geosimplebarchart	string	-
width	Field of the data selected by filterdata that will be mapped as the width of the geometry (only for box geometry).	string	-
depth	Field of the data selected by filterdata that will be mapped as the depth of the geometry (only for box geometry).	string	-

|

debug_data component

This component force the entity to hear an event, when this event occurs, a debug plane with the data of the baratariaData entity attribute will appear in the position (or close) of the entity that it belongs.

API

Property	Description	Type	Default value
inputEvent	Name of the event that will be hearing	string	-

interaction-mapper component

This component just map events of an entity to others customizables.

Property	Description	Type	Default value
input	Input event	string	-
output	Output event	string	-

Data model

The dataset returned from the parsing of the querier components must has this model:

{
    "key1" : {
        "prop1": ["test" , "foo", "data"],
        "prop2": 12123,
        "prop3": "Data here",
        ...
    },
    "key2" : {
        ...
    }
    ...
}

Type	Name	Latest commit message	Commit time
	Failed to load latest commit information.
	dist
	docs
	examples
	tests
	tools
	.gitignore
	.travis.yml
	LICENSE
	README.md
	debug_data.js
	filterdata.js
	geo3dbarchart.js
	geobubbleschart.js
	geocodecityjschart.js
	geopiechart.js
	geosimplebarchart.js
	index.html
	index.js
	interaction-mapper.js
	package.json
	querier_github.js
	querier_json.js
	vismapper.js

babiaxr/aframe-babia-components

README.md

Aframe-babia-components

Why

Usage

Browser Installation

NPM Installation

How to use this components

Chart components API

geopiechart component

API

Data format

geosimplebarchart component

API

Data format

geo3dbarchart component

API

Data format

bubblechart component

API

Data format

Querier/Filter/Mapper and other components API

querier_json component

API

querier_github component

API

filterdata component

API

vismapper component

API

debug_data component

API

interaction-mapper component

Data model

Examples available at the "examples folder" and here

babiaxr/aframe-babia-components

Join GitHub today

Clone with HTTPS

Downloading

Launching GitHub Desktop

Launching GitHub Desktop

Launching Xcode

Launching Visual Studio

README.md

Aframe-babia-components

Why

Usage

Browser Installation

NPM Installation

How to use this components

Chart components API

geopiechart component

API

Data format

geosimplebarchart component

API

Data format

geo3dbarchart component

API

Data format

bubblechart component

API

Data format

Querier/Filter/Mapper and other components API

querier_json component

API

querier_github component

API

filterdata component

API

vismapper component

API

debug_data component

API

interaction-mapper component

Data model

Examples available at the "examples folder" and here