universes

Retrieve universe information

Description

example

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

example

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

example

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

Examples

collapse all

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

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

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

collapse all

IHS Markit connection, specified as an ihsmarkitrs object.

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

Example: 'US Total Cap'

Data Types: char | string

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

collapse all

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 NameDescriptionData 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

Introduced in R2018b