--- title: "GivenName" language: "en" type: "Entity" summary: "Male and female given names." canonical_url: "https://reference.wolfram.com/language/ref/entity/GivenName.html" source: "Wolfram Language Documentation" related_guides: - title: "Entity Types" link: "https://reference.wolfram.com/language/guide/EntityTypes.en.md" --- # GivenName Male and female given names. [Related Interpreter](https://reference.wolfram.com/language/ref/interpreter/GivenName.en.md) Entity["GivenName", name] or Entity[...] represents an entity of type "GivenName". Entity[...][prop] gives the value of a specified property. Entity[...][{propi, …}] gives the value of a list of properties. Entity[...][prop, {quali -> vali, …}] gives the value of a specified property modified by qualifier rules quali -> vali. Entity[...][Dated[prop, date]] gives the value of a property associated with a particular date specification. EntityClass["GivenName", {propi -> speci, …}] represents a class of entities with values of propi defined by speci. ## Sample Entities * Entity["GivenName", {"Michael", "UnitedStates", "male"}]Entity["GivenName", {"Elizabeth", "UnitedStates", "female"}]Entity["GivenName", {"Jacob", "UnitedStates", "male"}]Entity["GivenName", {"James", "UnitedStates", "male"}]Entity["GivenName", {"Mary", "UnitedStates", "female"}]Entity["GivenName", {"Patricia", "UnitedStates", "female"}]Entity["GivenName", {"Robert", "UnitedStates", "male"}]Entity["GivenName", {"Sophia", "UnitedStates", "female"}]Entity["GivenName", {"Tracy", "UnitedStates", "female"}]Entity["GivenName", {"Tracy", "UnitedStates", "male"}]**…** ## 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 (8) ### Basic Examples (4) Use ctrl+= for entity discovery: ```wl In[1]:= [image] Out[1]= Entity["GivenName", {"Naomi", "UnitedStates", "female"}] ``` --- Find a property value for an entity: ```wl In[1]:= Entity["GivenName", {"Jacob", "UnitedStates", "male"}]["NotablePeople"] Out[1]= {Entity["Person", "JacobEpstein::4jh67"], Entity["Person", "JacobZuma::7jq5y"], Entity["Person", "JacobPitts::fnt8m"], Entity["Person", "JacobARiis::k62q4"], Entity["Person", "JacobVargas::9z747"], Entity["Person", "JacobSchiff::m2t6m"], Entity["Pe ... markin::j3347"], Entity["Person", "JacobGartnerLauman::c6472"], Entity["Person", "JacobLeibTalmon::j28gc"], Entity["Person", "JacobHGilbert::kvtd2"], Entity["Person", "JacobAugustusGeissenhainer::2793z"], Entity["Person", "JacobVanLennep::ck9fq"]} ``` --- Retrieve a dataset of all available properties for an entity: ```wl In[1]:= Entity["GivenName", {"Sophia", "UnitedStates", "female"}]["Dataset"] Out[1]= Dataset[Association[EntityProperty["GivenName", "AlternateVersions"] -> {Entity["GivenName", {"Sophie", "UnitedStates", "female"}], Entity["GivenName", {"Sophy", "UnitedStates", "female"}], "Suffina", Entity["GivenName", {"Sofia", "Un ... ophiaAggelonitis::749y8"], Entity["Person", "SophiaMariaWestenholz::6dwc6"], Entity["Person", "SophiaHanda::4t844"]}, EntityProperty["GivenName", "Number"] -> Quantity[12496, "People"/"Years"], EntityProperty["GivenName", "Rank"] -> 6]] ``` --- Find the 10 most common names for baby girls: ```wl In[1]:= EntityClass["GivenName", {"Rank" -> LessEqualThan[10], "Gender" -> "Female"}]//EntityList Out[1]= {Entity["GivenName", {"Amelia", "UnitedStates", "female"}], Entity["GivenName", {"Ava", "UnitedStates", "female"}], Entity["GivenName", {"Charlotte", "UnitedStates", "female"}], Entity["GivenName", {"Emma", "UnitedStates", "female"}], Entity["Given ... "female"}], Entity["GivenName", {"Isabella", "UnitedStates", "female"}], Entity["GivenName", {"Mia", "UnitedStates", "female"}], Entity["GivenName", {"Olivia", "UnitedStates", "female"}], Entity["GivenName", {"Sophia", "UnitedStates", "female"}]} ``` ### Scope (3) #### Implicit Entity Classes (1) Create an entity class of names in a given year with a rank lower than 5: ```wl In[1]:= EntityClass["GivenName", Dated[EntityProperty["GivenName", "Rank"], DateObject[{1980}, "Year", "Gregorian", -6.]] -> LessThan[5]]//EntityList Out[1]= {Entity["GivenName", {"Amanda", "UnitedStates", "female"}], Entity["GivenName", {"Christopher", "UnitedStates", "male"}], Entity["GivenName", {"David", "UnitedStates", "male"}], Entity["GivenName", {"Jason", "UnitedStates", "male"}], Entity["GivenName", {"Jennifer", "UnitedStates", "female"}], Entity["GivenName", {"Jessica", "UnitedStates", "female"}], Entity["GivenName", {"Melissa", "UnitedStates", "female"}], Entity["GivenName", {"Michael", "UnitedStates", "male"}]} ``` Create an entity class of names in a given year with a number greater than 1000 people per year: ```wl In[2]:= EntityClass["GivenName", Dated[EntityProperty["GivenName", "Number"], DateObject[{1990}, "Year", "Gregorian", -6.]] -> GreaterThan[Quantity[5000, "People" / "Years"]]]//EntityList Out[2]= {Entity["GivenName", {"Aaron", "UnitedStates", "male"}], Entity["GivenName", {"Adam", "UnitedStates", "male"}], Entity["GivenName", {"Alex", "UnitedStates", "male"}], Entity["GivenName", {"Alexander", "UnitedStates", "male"}], Entity["GivenName", { ... female"}], Entity["GivenName", {"Victoria", "UnitedStates", "female"}], Entity["GivenName", {"Whitney", "UnitedStates", "female"}], Entity["GivenName", {"William", "UnitedStates", "male"}], Entity["GivenName", {"Zachary", "UnitedStates", "male"}]} ``` #### Qualifiers (2) ##### Dates (1) Retrieve data for a given name in a specific year: ```wl In[1]:= EntityValue[Entity["GivenName", {"Charlotte", "UnitedStates", "female"}], EntityProperty["GivenName", "Rank", {"Date" -> DateObject[{1981}, "Year", "Gregorian", -5.]}]] Out[1]= 290 ``` ##### Time Series (1) Retrieve data for a given name for a range of years: ```wl In[1]:= EntityValue[Entity["GivenName", {"Arnold", "UnitedStates", "male"}], EntityProperty["GivenName", "Fraction", {"Date" -> All}]] Out[1]= TemporalData[TimeSeries, {{QuantityArray[StructuredArray`StructuredData[{143}, {CompressedData["«1628»"], "Percent", {{1}}}]]}, {TemporalData`DateSpecification[{1879, 12, 31, 20, 0, 0}, {2021, 12, 31, 20, 0, 0}, {1, "Year"}]}, 1, {"Continuous", 1}, {"Discrete", 1}, 1, {ResamplingMethod -> {"Interpolation", InterpolationOrder -> 1}, ValueDimensions -> 1}}, True, 14.3] In[2]:= DateListPlot[%] Out[2]= [image] ``` ### Neat Examples (1) Compare popularity trends for multiple names: ```wl In[1]:= With[{names = {Entity["GivenName", {"Aaron", "UnitedStates", "male"}], Entity["GivenName", {"Molly", "UnitedStates", "female"}], Entity["GivenName", {"Brandon", "UnitedStates", "male"}], Entity["GivenName", {"Gabby", "UnitedStates", "female"}], Entity["GivenName", {"Declan", "UnitedStates", "male"}]}}, DateListPlot[EntityValue[names, EntityProperty["GivenName", "Number", {"Date" -> All}]], PlotRange -> All, PlotLegends -> names]] Out[1]= [image] ``` ## See Also * [`Surname`](https://reference.wolfram.com/language/ref/entity/Surname.en.md) * [`PersonTitle`](https://reference.wolfram.com/language/ref/entity/PersonTitle.en.md) * [`Country`](https://reference.wolfram.com/language/ref/entity/Country.en.md) * [`Religion`](https://reference.wolfram.com/language/ref/entity/Religion.en.md) * [`GivenName`](https://reference.wolfram.com/language/ref/interpreter/GivenName.en.md) * [`ComputedGivenName`](https://reference.wolfram.com/language/ref/interpreter/ComputedGivenName.en.md) * [`GivenName`](https://reference.wolfram.com/language/ref/textcontent/GivenName.en.md) ## Related Guides * [Entity Types](https://reference.wolfram.com/language/guide/EntityTypes.en.md) ## History * [Introduced in 2019 (12.0)](https://reference.wolfram.com/language/guide/SummaryOfNewFeaturesIn120.en.md)