buidl-labs / foamviz

Central repository containing data visualizations over FOAM's TCR Data

FOAMViz

A suit of open source visualization tools over FOAM TCR's data to analyze ecosystem activity on FOAM's map.

This project is deployed live at https://foamviz.surge.sh

Table of contents

• About FOAMViz project
  • What is FOAMViz?
  • Why FOAMViz?
• Our three visualizations
  • Statistics around POI's
  • Cartographer's Journey
  • Evolution of FOAM on planetary scale
• Running the project locally
• ⛏️ Built Using
• ✍️ Authors

About FOAMViz project

What is FOAMViz?

FOAM’s Spatial Index & Visualizer has become a fascinating playground for people collaboratively coming to consensus around location data in a decentralized fashion.

This project focuses on the visualization of FOAM TCR’s data by providing visualization tools and experiments that let’s the community view the data in a more visual way.

Why FOAMViz?

The blockchain and crypto ecosystem is already as complex for an average joe to understand. And when the user can’t visualize how things work, they can’t really wrap their heads around the concept.

Because of the way the human brain processes information, using charts or graphs to visualize large amounts of complex data is easier than poring over raw numbers. Data visualization is a quick, easy way to convey concepts in a universal manner.

These tools + visualizations would help all users - including power users - to go through the data in a more visual way than currently possible.

Our three visualizations

Repo constains these three visualizations

• Statistics around POI's
• Cartographer's Journey
• Evolution of FOAM on planetary scale

Statistics around POI's

For the curious lot amongst the FOAM users this interactive tool will help answer the following questions:

• What are the low-density and high-density areas near me? Around the planet?
• What is the distribution of staked POI’s across these points?
• Do low-density areas have higher staked value of FOAM tokens?

Cartographer's Journey

Cartographers are an integral part of the FOAM ecosystem. This interactive tool allows you to view their journey in a time machine manner.

• Whiz through their journey flying through various countries and plotting points.
• Find out the attributes of places the cartographer is most passionate about.
• Or just sit back and hit play watching a small simulation of their journey!

Evolution of FOAM on planetary scale

This interactive tool will provide an overview of the amount staked in POI’s all over the globe from the inception of FOAM to now.

Questions that will help FOAM users answer:

• Which geography has the most activity?
• Staking patterns across geography?

Steps to run the project locally in development mode are:

1. Fork and clone the repository in your system and navigate to the project directory.
2. Setup an .env file in root of the project with REACT_APP_MAPBOX_ACCESS_TOKEN and provide your mapbox token.
3. Install all the project dependencies using npm install command.
4. Run npm start to start the local server. Open http://localhost:3000 to view the project in the browser.

⛏️ Built Using

• React JS - A JavaScript library for building user interfaces
• Deck GL - Large scale WebGL-powered data visualization
• Mapbox GL JS - A JavaScript library that uses WebGL to render interactive maps
• FOAM APIs - Official APIs built on FOAM's map
• Blocklytics FOAM API - APIs built for FOAM tools
• React Globe GL - Globe Data Visualization using ThreeJS/WebGL
• Surge - CLI for web publishing

✍️ Authors

• @prastut
• @dhruv10