universes

Retrieve universe information

Syntax

d = universes(c)

d = universes(c,universeid)

d = universes(c,universeid,requesttype)

Description

d = universes(c) returns universe information for all universes using an IHS Markit^® connection.

d = universes(c,universeid) returns universe information for a specific universe.

d = universes(c,universeid,requesttype) returns universe information based on the request type.

Examples

Retrieve Universe Information for All Universes

Using an IHS Markit connection, retrieve universe information for all universes.

Create an IHS Markit connection using your user name and password. c is an ihsmarkitrs object.

username = 'ABCDEF';
password = 'ABC123';
c = ihsmarkitrs(username,password);

Retrieve universe information for all universes using the IHS Markit connection. d is a table that contains the universe information.

d = universes(c);

Display information for the first few universes.

head(d)

ans =

  8×6 table

    description                region                universeType    identifier    universeId                universe            
    ___________    ______________________________    ____________    __________    __________    ________________________________

        ''         'Europe, Middle East & Africa'      'Global'          []            248       'Asset4 Europe'                 
        ''         '11,12,13,14'                       'Global'          []            227       'Asset4 Global'                 
        ''         '11,12'                             'Global'          []            250       'Asset4 North America'          
        ''         'Far East'                          'Global'          []            249       'Asset4 Pacific'                
        ''         'Far East'                          'Global'          []            228       'Asset4 US'                     
        ''         '11,12,13,14'                       'UDM'             []            324       'Global Dividend'               
        ''         '11,12,13,14'                       'Global'          []           1552       'Global Semi Conductor Universe'
        ''         '11,12,13,14'                       'Global'          []           1293       'Markit Developed World'        

The variables are:

• description — Universe description

• region — Country or region code

• universeType — Universe type

• identifier — Identification type

• universeId — Universe identifier

• universe — Universe name

Retrieve Universe Information for Specific Universe

Using an IHS Markit connection, retrieve universe information for a specific universe.

Create an IHS Markit connection using your user name and password. c is an ihsmarkitrs object.

username = 'ABCDEF';
password = 'ABC123';
c = ihsmarkitrs(username,password);

Retrieve universe information for the QSG World universe using the IHS Markit connection. d is a table that contains the universe information.

universeid = "QSG World";
d = universes(c,universeid)

d =

  1×6 table

    description       region        universeType    identifier    universeId     universe  
    ___________    _____________    ____________    __________    __________    ___________

        ''         '11,12,13,14'      'Global'       'Sedol'         133        'QSG World'

The variables are:

• description — Universe description

• region — Country or region code

• universeType — Universe type

• identifier — Identification type

• universeId — Universe identifier

• universe — Universe name

Retrieve Universe Information for Specific Request Type

Using an IHS Markit connection, retrieve universe information for a specific universe. Specify a historical request to retrieve historical information for the universe.

Create an IHS Markit connection using your user name and password. c is an ihsmarkitrs object.

username = 'ABCDEF';
password = 'ABC123';
c = ihsmarkitrs(username,password);

Retrieve universe information for the QSG World universe using the IHS Markit connection. Specify retrieving historical information by using the HistoryDetail request type. d is a table that contains the historical universe information.

universeid = "QSG World";
requesttype = 'HistoryDetail';
d = universes(c,universeid,requesttype)

d =

  2×4 table

     universe      freqType      startDate        endDate   
    ___________    _________    ____________    ____________

    'QSG World'    'Daily'      '03/22/2007'    '03/14/2018'
    'QSG World'    'Monthly'    '12/30/1988'    '05/31/2017'

The variables are:

• universe — Universe name

• freqType — Data frequency (or periodicity)

• startDate — Start date of the life of the universe

• endDate — End date of the life of the universe

Input Arguments

c — IHS Markit connection

ihsmarkitrs object

IHS Markit connection, specified as an ihsmarkitrs object.

universeid — Universe name

character vector | string scalar

Universe name, specified as a character vector or string scalar.

Example: 'US Total Cap'

Data Types: char | string

requesttype — Request type

character vector | string scalar

Request type, specified as the value 'HistoryDetail', 'Mapping', or 'Country'. Use the 'HistoryDetail' value to return historical information from the universe that you specify using the universeid input argument. Use the 'Mapping' value to return a list of the factors in the specified universe. Use the 'Country' value to return the country identifiers that apply to the specified universe.

You can specify each value as a character vector or string scalar.

Output Arguments

d — Universe information

table

Universe information, returned as a table. The following table describes the variables in the returned data. (The variables vary depending on the request type that you specify in the requesttype input argument.)

Variable Name	Description	Data Type
universeId	Universe identifier	double
description	Universe description	cell array of character vectors
region	Country or region code	cell array of character vectors
universeType	Universe type	cell array of character vectors
identifier	Identification type	cell array of character vectors
universe	Universe name	cell array of character vectors
freqType	Data frequency (or periodicity)	cell array of character vectors
startDate	Start date of the life of the universe	cell array of character vectors
endDate	End date of the life of the universe	cell array of character vectors
data	Factors in the universe	structure
country	Countries that apply to the universe	cell array of character vectors