Skip to content

Commit 2464543

Browse files
authored
Update README.md
1 parent 63c2543 commit 2464543

File tree

1 file changed

+18
-4
lines changed

1 file changed

+18
-4
lines changed

README.md

Lines changed: 18 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -4,6 +4,8 @@ Node.js / promise-based data provider about name usage of babies born 1880-2023
44
[![NPM version][npm-image]][npm-url] [![Node.js Package](https://github.com/jonroig/usBabyNames.js/actions/workflows/npm-publish.yml/badge.svg)](https://github.com/jonroig/usBabyNames.js/actions/workflows/npm-publish.yml)
55

66
# New!
7+
**2024-08-10** Added 115,604 name details including pronunciation / origin / usage / notes. Moved to proper ES6 exports.
8+
79
**2024-08-03**: Updated: latest names for 2021-2023. We're up to 2,114,982 rows of data, 103,406 rows of names.
810

911
2021-07-21: Updated with the latest baby names... brought the names current to 2020, reloaded the SQL db. That's 100,263 names / 2,019,529 rows of data over 140 years.
@@ -16,11 +18,14 @@ Node.js / promise-based data provider about name usage of babies born 1880-2023
1618

1719

1820
# About
19-
Built on <a href="https://www.ssa.gov/OACT/babynames/limits.html">the Social Security Administration baby names files</a>, usBabyNames.js returns interesting historical data on baby name usage from 1880-2020. With almost two million total entries packaged within a sqlite3 database, each record contains the following:
21+
Built on <a href="https://www.ssa.gov/OACT/babynames/limits.html">the Social Security Administration baby names files</a>, usBabyNames.js returns interesting historical data on baby name usage from 1880-2023. With almost two million total entries packaged within a sqlite3 database, each record contains the following:
2022
- Name
2123
- Sex
2224
- Number of births that year
2325
- Rank for that year
26+
- Pronunciation
27+
- Notes about history and usage
28+
- Origin
2429

2530
This allows you to easily do the following:
2631
- Identify naming trends based on real data
@@ -162,15 +167,24 @@ I've done all the "hard" work of exporting all the historical United States birt
162167
This database is 100% public domain and freely available for whatever purposes you like. Enjoy! Thanks SSA!
163168

164169
You can access the baby name sqlite database directly from the command line like so:
165-
```
166-
sqlite3 sqlite/us-name-data.sqlite
170+
``` sql
171+
# sqlite3 sqlite/us-name-data.sqlite
167172

168173
select * from usNameData WHERE name = 'jonathan' AND year = 1975 AND sex = 'M';
169174

170175
select * from usNameData WHERE name = 'jonathan' AND sex = 'M' ORDER BY year DESC;
171176
```
172177

173-
# Data Source: Government Fine Print
178+
# Name Meanings / Pronunciation / Details database
179+
Generated by Chat GPT 4o over the course of a few days in August 10, I attempted to fill in more name details. Any improvments, totally welcome. This should be considered non-copyrighted material, so feel free to use it as you like.
180+
181+
``` sql
182+
# sqlite3 sqlite/us-name-details.sqlite
183+
184+
select * from usNameDetails where name = 'bertha' AND sex = 'F';
185+
```
186+
187+
# USA Historical Name Data Source: Government Fine Print
174188
.. from the Original YOB Source Files:
175189

176190
National Data on the relative frequency of given names in the population of U.S. births where the individual has a Social Security Number

0 commit comments

Comments
 (0)