Wolfram Language & System Documentation Center

GivenName

Related Interpreter »
Male and female given names.

Entity["GivenName",name] or

represents an entity of type "GivenName".

[prop]

gives the value of a specified property.

[{propi,…}]

gives the value of a list of properties.

[prop,{qualivali,…}]

gives the value of a specified property modified by qualifier rules quali->vali.

[Dated[prop,date]]

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

EntityClass["GivenName",{propispeci,…}]

represents a class of entities with values of propi defined by speci.

Sample Entities

  • …

Properties

  • AlternateVersionsalternate versions
    EntityClassesentity classes
    EntityTypeListentity type list
    Etymologyetymology
    ExpectedFractionexpected population fraction
    ExpectedRankexpected rank
    Fractionfraction
    Gendergender
    GivenNameDistributionage distribution
    GivenNameTotalexpected total number alive today
    MostCommonAgemost common age
    Namename
    NotablePeoplenotable people
    Numbercurrent naming frequency
    Rankrank

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 all close 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: