https://github.com/oh-kay-blanket/blood-lines

An application for visualizing family tree data in a 3D space.
https://github.com/oh-kay-blanket/blood-lines

Last synced: 7 days ago
JSON representation

An application for visualizing family tree data in a 3D space.

• Host: GitHub
• URL: https://github.com/oh-kay-blanket/blood-lines
• Owner: oh-kay-blanket
• License: gpl-3.0
• Created: 2019-10-08T08:33:05.000Z (about 5 years ago)
• Default Branch: master
• Last Pushed: 2023-12-03T19:54:04.000Z (12 months ago)
• Last Synced: 2024-05-22T02:12:43.533Z (6 months ago)
• Language: JavaScript
• Homepage: https://oh-kay-blanket.github.io/blood-lines/
• Size: 44.6 MB
• Stars: 60
• Watchers: 6
• Forks: 11
• Open Issues: 1
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# Blood Lines

Blood Lines is a tool for visualizing family tree data in an interactive, 3D space.  

- [Install](#install)

- [Using Blood Lines](#using-blood-lines)

  - [Left-click & drag](#left-click--drag)

  - [Right-click & drag](#right-click--drag)

  - [Mouse wheel](#mouse-wheel)

  - [Left-click on node](#left-click-on-node)

  - [Right-click on node](#right-click-on-node)

- [About Blood Lines](#about-blood-lines)

  - [Data Parsing](#data-parsing)

  - [Visualization](#visualization)

- [About GEDCOM](#about-gedcom)

## Install

`git clone https://github.com/mister-blanket/blood-lines.git blood-lines && cd blood-lines && npm i`    

`npm start`

## Using Blood Lines

#### Left-click & drag

Moves the camera.

#### Right-click & drag

Pans the camera.

#### Mouse wheel

 Zooms the camera.

#### Left-click on node

Mutes all other nodes which are not directly linked to the selected node. Clicking on that node again will unmute other nodes.

#### Right-click on node

Zooms in on node and set it as the new pivot point for the camera.

## About Blood Lines

#### Data Parsing

Blood Lines uses [GEDCOM-d3](https://github.com/mister-blanket/gedcom-d3), a custom GEDCOM parser designed for this project. It is based off of the [tmcw/parse-gedcom](https://github.com/tmcw/parse-gedcom) project.

#### Visualization

Blood Lines uses [3D Force-Directed Graph](https://github.com/vasturiano/3d-force-graph) for visualization.

## About GEDCOM

[GEDCOM](https://en.wikipedia.org/wiki/GEDCOM) is an open standard for exchanging genealogical data between different genealogy software. If you have created a family tree using a computer program or website, chances are you can export your data as a GEDCOM file.

If you haven't created a family tree, but are interested, there are many websites and applications available to help you do so. I recommend [GRAMPS](https://gramps-project.org/introduction-WP/), which is free and open-source genealogy software.