--- title: "Ocean" language: "en" type: "Entity" summary: "Oceans, seas, bays and other bodies of salt water." canonical_url: "https://reference.wolfram.com/language/ref/entity/Ocean.html" source: "Wolfram Language Documentation" related_guides: - title: "Entity Types" link: "https://reference.wolfram.com/language/guide/EntityTypes.en.md" --- # Ocean Oceans, seas, bays and other bodies of salt water. [Related Interpreter](https://reference.wolfram.com/language/ref/interpreter/Ocean.en.md) Entity["Ocean", name] or Entity[...] represents an entity of type "Ocean". Entity[...][prop] gives the value of a specified property. Entity[...][{propi, …}] gives the value of a list of properties. EntityClass["Ocean", {propi -> speci, …}] represents a class of entities with values of propi defined by speci. ## Sample Entities * Entity["Ocean", "AmundsenSea"]Entity["Ocean", "BristolBay"]Entity["Ocean", "CaribbeanSea"]Entity["Ocean", "NorwegianSea"]Entity["Ocean", "PacificOcean"]Entity["Ocean", "ScotiaSea"]Entity["Ocean", "SouthernOcean"]Entity["Ocean", "ThreeCliffsBay"]Entity["Ocean", "YellowSea"]Entity["Ocean", "ZalivShelikhova"]**…** ## Sample Entity Classes * EntityClass["Ocean", "Basins"]EntityClass["Ocean", "Bays"]EntityClass["Ocean", "Channels"]EntityClass["Ocean", "Gulfs"]EntityClass["Ocean", "Oceans"]EntityClass["Ocean", "Seas"]EntityClass["Ocean", "SevenSeas"]EntityClass["Ocean", "Straits"]**…** ## Properties | | | | -------------------------- | ----------------------------- | | ACICM491Code | ACICM491 code | | Area | area | | AverageDepth | average depth | | Basins | basins | | BorderingBodiesOfWater | bordering bodies of water | | BorderingContinents | bordering continents | | BorderingCountries | bordering countries | | CenterCoordinates | center coordinates | | CoastlineLength | coastline length | | Countries | countries | | DIAM6518Code | DIAM6518 code | | EastWestExtent | east-west extent | | EntityClasses | entity classes | | EntityTypeList | entity type list | | HasPolygon | has polygon? | | IHO233Code | IHO233 code | | IHO234Code | IHO234 code | | Latitude | latitude | | LatitudeRange | latitude range | | Longitude | longitude | | LongitudeRange | longitude range | | LowestPointLocation | lowest point location | | MajorCityPorts | major city ports | | MajorIslands | major islands | | MajorRivers | major rivers | | MaximumDepth | maximum depth | | Memberships | memberships | | Name | name | | NaturalResources | natural resources | | NorthSouthExtent | north-south extent | | PercentAreaOfEarthsSurface | percentage of earth's surface | | Polygon | polygon | | Position | position | | Salinity | typical salinity | | UnderseaFeatures | undersea features | ## Details * ``"Ocean"`` entities include oceans and seas, as well as bays, straits, gulfs and other bodies of salt water. * ``"Ocean"`` entity classes group entities by type or notable groups, such as ``"Oceans"`` or ``"SevenSeas"``. * Some properties are available for the ``"Ocean"`` entity type as a whole and can be given using the form ``EntityValue["Ocean", 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["Ocean", 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["Ocean", "PacificOcean"] ``` --- Find a property value for an entity: ```wl In[1]:= Entity["Ocean", "NorwegianSea"]["MajorCityPorts"] Out[1]= {Entity["City", {"Bergen", "Hordaland", "Norway"}], Entity["City", {"Narvik", "Nordland", "Norway"}], Entity["City", {"Torshavn", "Torshavn", "FaroeIslands"}], Entity["City", {"Vagur", "Sudhuroy", "FaroeIslands"}]} ``` --- Retrieve a dataset of all available properties for an entity: ```wl In[1]:= Entity["Ocean", "YellowSea"]["Dataset"]//DeleteMissing Out[1]= Dataset[Association[EntityProperty["GeoRegion", "HasPolygon"] -> True, EntityProperty["GeoRegion", "Polygon"] -> Polygon[GeoPosition[CompressedData["«12240»"]]], EntityProperty["Ocean", "Area"] -> Quantity[146718.8202461294219598948`4., " ... Entity["UnderseaFeature", "GalmaegiReef"]}, EntityProperty["Thing", "EntityClasses"] -> {EntityClass["Ocean", "Seas"]}, EntityProperty["Thing", "EntityTypeList"] -> {EntityType["Ocean"]}, EntityProperty["Thing", "Name"] -> "Yellow Sea"]] ``` --- Find the deepest ocean bordering Italy: ```wl In[1]:= EntityClass["Ocean", {EntityProperty["Ocean", "MaximumDepth"] -> TakeSmallest[1], EntityProperty["Ocean", "BorderingCountries"] -> Entity["Country", "Italy"]}]//EntityList Out[1]= {Entity["Ocean", "StraitsBonifacio"]} ``` ### Scope (4) Retrieve multiple properties of an ocean: ```wl In[1]:= \[FreeformPrompt]["aegean sea"][{EntityProperty["Ocean", "Area"], EntityProperty["Ocean", "AverageDepth"], EntityProperty["Ocean", "MajorCityPorts"]}] Out[1]= {Quantity[82625.8619280834113142566`4., "Miles"^2], Quantity[-1148.293963254593175853`4., "Feet"], {Entity["City", {"Izmir", "Izmir", "Turkey"}], Entity["City", {"Athens", "Attiki", "Greece"}], Entity["City", {"Athens", "Attiki", "Greece"}], Entity["City", {"Thessaloniki", "Thessaloniki", "Greece"}], Entity["City", {"Iraklion", "Iraklion", "Greece"}], Entity["City", {"Tekirdag", "Tekirdag", "Turkey"}], Entity["City", {"Aliaga", "Izmir", "Turkey"}]}} ``` --- Show a map of the Mediterranean Sea: ```wl In[1]:= GeoGraphics[{Red, Polygon@\[FreeformPrompt]["Mediterranean Sea"]}] Out[1]= [image] ``` --- Find the ocean with the highest saline content: ```wl In[1]:= EntityList@Entity["Ocean", EntityProperty["Ocean", "Salinity"] -> TakeLargest[1]] Out[1]= {Entity["Ocean", "AtlanticOcean"]} ``` --- Show the Aegean Sea (blue) and the Ionian Sea (green) within the boundaries of the Mediterranean Sea: ```wl In[1]:= GeoGraphics[{EdgeForm[{Thickness[0.001], Blue}], Blue, \[FreeformPrompt]["aegean sea"][EntityProperty["Ocean", "Polygon"]], EdgeForm[{Thickness[0.001], Green}], Green, Entity["Ocean", "IonianSea"][EntityProperty["Ocean", "Polygon"]]}, GeoRange -> \[FreeformPrompt]["Mediterranean Sea"]] Out[1]= [image] ``` ## See Also * [`Island`](https://reference.wolfram.com/language/ref/entity/Island.en.md) * [`UnderseaFeature`](https://reference.wolfram.com/language/ref/entity/UnderseaFeature.en.md) * [`Reef`](https://reference.wolfram.com/language/ref/entity/Reef.en.md) * [`Beach`](https://reference.wolfram.com/language/ref/entity/Beach.en.md) * [`Lake`](https://reference.wolfram.com/language/ref/entity/Lake.en.md) * [`Mountain`](https://reference.wolfram.com/language/ref/entity/Mountain.en.md) * [`Volcano`](https://reference.wolfram.com/language/ref/entity/Volcano.en.md) * [`River`](https://reference.wolfram.com/language/ref/entity/River.en.md) * [`Glacier`](https://reference.wolfram.com/language/ref/entity/Glacier.en.md) * [`Waterfall`](https://reference.wolfram.com/language/ref/entity/Waterfall.en.md) * [`EarthImpact`](https://reference.wolfram.com/language/ref/entity/EarthImpact.en.md) * [`Desert`](https://reference.wolfram.com/language/ref/entity/Desert.en.md) * [`Forest`](https://reference.wolfram.com/language/ref/entity/Forest.en.md) * [`Ocean`](https://reference.wolfram.com/language/ref/interpreter/Ocean.en.md) * [`ComputedOcean`](https://reference.wolfram.com/language/ref/interpreter/ComputedOcean.en.md) * [`Ocean`](https://reference.wolfram.com/language/ref/textcontent/Ocean.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)