GivenName

Male and female given names.

Entity["GivenName",name] or

represents an entity of type "GivenName".

[prop]

gives the value of a specified property.

[{prop_i,…}]

gives the value of a list of properties.

[prop,{qual_ival_i,…}]

gives the value of a specified property modified by qualifier rules qual_i->val_i.

[Dated[prop,date]]

gives the value of a property associated with a particular date specification.

EntityClass["GivenName",{prop_ispec_i,…}]

represents a class of entities with values of prop_i defined by spec_i.

Sample Entities

Properties

	AlternateVersions	alternate versions
	EntityClasses	entity classes
	EntityTypeList	entity type list
	Etymology	etymology
	ExpectedFraction	expected population fraction
	ExpectedRank	expected rank
	Fraction	fraction
	Gender	gender
	GivenNameDistribution	age distribution
	GivenNameTotal	expected total number alive today
	MostCommonAge	most common age
	Name	name
	NotablePeople	notable people
	Number	current naming frequency
	Rank	rank

Details

"GivenName" entities represent given names reported to the United States Social Security Administration.
Given names are limited to those that were reported five or more times in any given year. Extremely rare names may not be represented.
Some properties are available for the "GivenName" entity type as a whole and can be given using the form EntityValue["GivenName",property]. Such properties include:

	"Properties"	the list of available properties
	"PropertyCanonicalNames"	the standard names of available properties
	"SampleEntities"	a sample list of available entities (typically of length 10)
	"SampleEntityClasses"	a sample list of available entity classes (typically of length 10)
	"EntityCount"	number of entities available
	"Entities"	the list of available entities
	"EntityCanonicalNames"	the standard names of available entities
	"EntityClasses"	the list of available entity classes
	"EntityClassCanonicalNames"	the standard names of available entity classes
	"PropertyClasses"	the list of available property classes
	"PropertyClassCanonicalNames"	the standard names of available property classes
	"PropertyCount"	number of properties available

The following annotations can be used in the third argument of EntityValue["GivenName",property,annotation]:

	"Source"	source information for the property
	"Date"	the date associated with the entity-property value (if any)
	"EntityAssociation"	an association of entities and entity-property values
	"PropertyAssociation"	an association of properties and entity-property values
	"EntityPropertyAssociation"	an association in which the specified entities are keys, and values are a nested association of properties and entity-property values
	"PropertyEntityAssociation"	an association in which the specified properties are keys, and values are a nested association of entities and entity-property values
	"Dataset"	a dataset in which the specified entities are keys, and values are an association of property names and entity-property values

The following annotations can be used in the second argument of EntityValue[property,annotation]:

	"Qualifiers"	the list of possible qualifiers for the property
	"QualifierValues"	the list of possible values that can be given to each qualifier
	"DefaultQualifierValues"	the list of default values for the property's qualifiers
	"Description"	a brief textual description of the property
	"Definition"	a detailed textual definition of the property
	"PhysicalQuantity"	the physical quantity associated with the entity-property value
	"Unit"	the unit associated with the entity-property value

A qualifier value of Automatic indicates that an applicable format of values can be used; e.g. for the "Date" qualifier, this includes a proper date or date span.

Examples

open allclose all

Basic Examples (4)

Use for entity discovery:

Find a property value for an entity:

Retrieve a dataset of all available properties for an entity:

Find the 10 most common names for baby girls:

Scope (3)

Implicit Entity Classes (1)

Create an entity class of names in a given year with a rank lower than 5:

Create an entity class of names in a given year with a number greater than 1000 people per year:

Qualifiers (2)

Dates (1)

Retrieve data for a given name in a specific year:

Time Series (1)

Retrieve data for a given name for a range of years:

Neat Examples (1)

Compare popularity trends for multiple names:

Top