https://github.com/rahulsom/genealogy
Java api to US Census Genealogy Data
https://github.com/rahulsom/genealogy
census-data genealogy java
Last synced: 6 months ago
JSON representation
Java api to US Census Genealogy Data
- Host: GitHub
- URL: https://github.com/rahulsom/genealogy
- Owner: rahulsom
- License: apache-2.0
- Created: 2014-01-10T03:33:37.000Z (almost 12 years ago)
- Default Branch: master
- Last Pushed: 2025-02-21T21:47:48.000Z (9 months ago)
- Last Synced: 2025-04-22T10:35:19.534Z (7 months ago)
- Topics: census-data, genealogy, java
- Language: Java
- Size: 3.04 MB
- Stars: 5
- Watchers: 3
- Forks: 5
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
Genealogy
====
Java library to generate names for people based on distributions inferred from US Census data for 1990 and 2000.
Sources
----
The first names are gathered from the 1990 census. The last names are gathered from the 2000 census.
Usage
----
This is the old API, low level but (slightly) faster.
It has no support for race.
```java
NameDbUsa instance = NameDbUsa.getInstance();
String firstName = instance.getMaleName();
String lastName = instance.getLastName();
String welcome = "Hello " + firstName + " " + lastName;
System.out.println (welcome);
```
This is the new API, high level but with great support for race.
```java
NameDbUsa instance = NameDbUsa.getInstance();
Person person = instance.getPerson();
String description = person.getFirstName() + " " +
person.getLastName() + " is of race '" +
person.getRace() + "' and gender '" +
person.getGender() + "'.";
System.out.println (description);
```
If you want consistent names, this is an option
```java
long l = 42;
Person person = instance.getPerson(l);
```
If you want to download the library from Sonatype, add this to your dependencies
section:
com.github.rahulsom:genealogy:1.3
To browse the latest builds, you can see [MavenRepository](http://mvnrepository.com/artifact/com.github.rahulsom/genealogy). It also has instructions for Maven, Gradle, Ivy, sbt, etc.
And add this to your repositories section:
https://oss.sonatype.org/content/groups/public
You can browse latest snapshots on:
http://oss.sonatype.org/content/repositories/snapshots/com/github/rahulsom/genealogy/
Builds
------
This project is being built on travis. See
[https://travis-ci.org/rahulsom/genealogy](https://travis-ci.org/rahulsom/genealogy)
It gets automatically deployed to [Sonatype OSS](https://oss.sonatype.org/).
[](https://travis-ci.org/rahulsom/genealogy)
[](https://dependabot.com)