getbulkdata

Объемные данные с информацией о заголовке для Bloomberg связь B-PIPE V3

Описание

пример

d = getbulkdata(c,s,f) возвращает объемные данные для полей f поскольку безопасность перечисляет s использование bloombergBPIPE объект c с интерфейсом Bloomberg® B-PIPE® C ++.

пример

d = getbulkdata(c,s,f,o,ov) возвращает объемные данные с помощью полей o переопределения с соответствующими значениями переопределения ov.

пример

d = getbulkdata(c,s,f,o,ov,Name,Value) возвращает объемные данные с дополнительными опциями, заданными одним или несколькими аргументами пары "имя-значение" для настроек запроса Bloomberg.

пример

[d,sec] = getbulkdata(___) дополнительно возвращается, безопасность перечисляют sec использование любой из комбинаций входных аргументов в предыдущих синтаксисах.

Примеры

свернуть все

Создайте связь B-PIPE Bloomberg с помощью IP-адреса машины, запускающей процесс B-PIPE Bloomberg. Этот пример использует B-PIPE Bloomberg, с которым соединяет интерфейсом C++, и принимает следующее:

  • Аутентификация является аутентификацией Windows®, когда вы устанавливаете authtype к 'OS_LOGON'.

  • Имя приложения является пробелом, потому что вы не соединяете с Bloomberg B-PIPE с помощью приложения.

  • IP-адресом для машины, запускающей процесс B-PIPE Bloomberg, является '111.11.11.112'.

  • Номером порта машины, запускающей процесс B-PIPE Bloomberg, является 8194.

c bloombergBPIPE объект.

authtype = 'OS_LOGON';
appname = '';
ipaddress = {'111.11.11.112'};
port = 8194;

c = bloombergBPIPE(authtype,appname,ipaddress,port);

Возвратите историю дивиденда для IBM®.

security = 'IBM US Equity';
field = 'DVD_HIST'; % Dividend history field

[d,sec] = getbulkdata(c,security,field) 
d = 

    DVD_HIST: {{149x7 cell}}

sec = 

    'IBM US Equity'

d структура с одним полем, которое содержит массив ячеек с возвращенными объемными данными. sec содержит имя безопасности IBM.

Отобразите историю дивиденда со связанной информацией о заголовке путем доступа к полю DVD_HIST структуры. Это поле является массивом ячеек, который содержит один массив ячеек. Вложенный массив ячеек содержит данные об истории дивиденда. Доступ к содержимому вложенной ячейки, использующей индексацию массива ячеек.

d.DVD_HIST{1}
ans = 

  Columns 1 through 6

    'Declared Date'    'Ex-Date'    'Record Date'    'Payable Date'    'Dividend Amount'    'Dividend Frequency'
    [       735536]    [ 735544]    [     735546]    [      735578]    [         0.95]      'Quarter'           
    [       735445]    [ 735453]    [     735455]    [      735487]    [         0.95]      'Quarter'           
    [       735354]    [ 735362]    [     735364]    [      735395]    [         0.95]      'Quarter'           
    ...

  Column 7

    'Dividend Type'
    'Regular Cash' 
    'Regular Cash' 
    'Regular Cash' 
    ...

Первая строка данных об истории дивиденда является информацией о заголовке, которая описывает содержимое каждого столбца.

Закройте связь Bloomberg.

close(c)

Создайте связь B-PIPE Bloomberg с помощью IP-адреса машины, запускающей процесс B-PIPE Bloomberg. Этот пример использует B-PIPE Bloomberg, с которым соединяет интерфейсом C++, и принимает следующее:

  • Аутентификация является аутентификацией Windows, когда вы устанавливаете authtype к 'OS_LOGON'.

  • Имя приложения является пробелом, потому что вы не соединяете с Bloomberg B-PIPE с помощью приложения.

  • IP-адресом для машины, запускающей процесс B-PIPE Bloomberg, является '111.11.11.112'.

  • Номером порта машины, запускающей процесс B-PIPE Bloomberg, является 8194.

c bloombergBPIPE объект.

authtype = 'OS_LOGON';
appname = '';
ipaddress = {'111.11.11.112'};
port = 8194;

c = bloombergBPIPE(authtype,appname,ipaddress,port);

Возвратите историю дивиденда для IBM с датами дивиденда с 1 января 2004 до 1 января 2005.

security = 'IBM US Equity';
field = 'DVD_HIST';                        % Dividend history field
override = {'DVD_START_DT','DVD_END_DT'};  % Dividend start and 
                                           % End dates
overridevalues = {'20040101','20050101'};

[d,sec] = getbulkdata(c,security,field,override,overridevalues)
d = 

    DVD_HIST: {{5x7 cell}}

sec = 

    'IBM US Equity'

d структура с одним полем, которое содержит массив ячеек с возвращенными объемными данными. sec содержит имя безопасности IBM.

Отобразите историю дивиденда со связанной информацией о заголовке путем доступа к полю DVD_HIST структуры. Это поле является массивом ячеек, который содержит один массив ячеек. Вложенный массив ячеек содержит данные об истории дивиденда. Доступ к содержимому вложенной ячейки, использующей индексацию массива ячеек.

d.DVD_HIST{1}
ans = 

  Columns 1 through 6

    'Declared Date'    'Ex-Date'    'Record Date'    'Payable Date'    'Dividend Amount'    'Dividend Frequency'
    [       732246]    [ 732259]    [     732261]    [      732291]    [         0.18]      'Quarter'           
    [       732155]    [ 732165]    [     732169]    [      732200]    [         0.18]      'Quarter'           
    [       732064]    [ 732073]    [     732077]    [      732108]    [         0.18]      'Quarter'           
    [       731973]    [ 731983]    [     731987]    [      732016]    [         0.16]      'Quarter'           

  Column 7

    'Dividend Type'
    'Regular Cash' 
    'Regular Cash' 
    'Regular Cash' 
    'Regular Cash'

Первая строка данных об истории дивиденда является информацией о заголовке, которая описывает содержимое каждого столбца.

Закройте связь Bloomberg.

close(c)

Создайте связь B-PIPE Bloomberg с помощью IP-адреса машины, запускающей процесс B-PIPE Bloomberg. Этот пример использует B-PIPE Bloomberg, с которым соединяет интерфейсом C++, и принимает следующее:

  • Аутентификация является аутентификацией Windows, когда вы устанавливаете authtype к 'OS_LOGON'.

  • Имя приложения является пробелом, потому что вы не соединяете с Bloomberg B-PIPE с помощью приложения.

  • IP-адресом для машины, запускающей процесс B-PIPE Bloomberg, является '111.11.11.112'.

  • Номером порта машины, запускающей процесс B-PIPE Bloomberg, является 8194.

c bloombergBPIPE объект.

authtype = 'OS_LOGON';
appname = '';
ipaddress = {'111.11.11.112'};
port = 8194;

c = bloombergBPIPE(authtype,appname,ipaddress,port);

Возвратите цену закрытия и историю дивиденда для IBM с датами дивиденда с 1 января 2004 до 1 января 2005. Укажите, что данные возвращают формат как вектор символов путем установки аргумента пары "имя-значение" 'returnFormattedValue' к 'true'.

security = 'IBM US Equity';
fields = {'LAST_PRICE','DVD_HIST'};        % Closing price and 
                                           % Dividend history fields
override = {'DVD_START_DT','DVD_END_DT'};  % Dividend start and 
                                           % End dates
overridevalues = {'20040101','20050101'};

[d,sec] = getbulkdata(c,security,fields,override,overridevalues,...
                      'returnFormattedValue',true)
d = 

      DVD_HIST: {{5x7 cell}}
    LAST_PRICE: {'188.74'}

sec = 

    'IBM US Equity'

d структура с двумя полями. Первое поле DVD_HIST содержит массив ячеек с историческими данными дивиденда как массив ячеек. Второе поле LAST_PRICE содержит массив ячеек с ценой закрытия как вектор символов. sec содержит имя безопасности IBM.

Отобразите цену закрытия.

d.LAST_PRICE
ans = 

    '188.74'

Отобразите историю дивиденда со связанной информацией о заголовке путем доступа к полю DVD_HIST структуры. Это поле является массивом ячеек, который содержит один массив ячеек. Вложенный массив ячеек содержит данные об истории дивиденда. Доступ к содержимому вложенной ячейки, использующей индексацию массива ячеек.

d.DVD_HIST{1}
ans = 

  Columns 1 through 6

    'Declared Date'    'Ex-Date'    'Record Date'    'Payable Date'    'Dividend Amount'    'Dividend Frequency'
    [       732246]    [ 732259]    [     732261]    [      732291]    [         0.18]      'Quarter'           
    [       732155]    [ 732165]    [     732169]    [      732200]    [         0.18]      'Quarter'           
    [       732064]    [ 732073]    [     732077]    [      732108]    [         0.18]      'Quarter'           
    [       731973]    [ 731983]    [     731987]    [      732016]    [         0.16]      'Quarter'           

  Column 7

    'Dividend Type'
    'Regular Cash' 
    'Regular Cash' 
    'Regular Cash' 
    'Regular Cash'

Первая строка данных об истории дивиденда является информацией о заголовке, которая описывает содержимое каждого столбца.

Закройте связь Bloomberg.

close(c)

Создайте связь Bloomberg, и затем запросите данные об истории дивиденда. getbulkdata функция возвращает данные для дат как datetime массив.

Создайте связь B-PIPE Bloomberg с помощью IP-адреса машины, запускающей процесс B-PIPE Bloomberg. Этот пример использует B-PIPE Bloomberg, с которым соединяет интерфейсом C++, и принимает следующее:

  • Аутентификация является аутентификацией Windows, когда вы устанавливаете authtype к 'OS_LOGON'.

  • Имя приложения является пробелом, потому что вы не соединяете с Bloomberg B-PIPE с помощью приложения.

  • IP-адресом для машины, запускающей процесс B-PIPE Bloomberg, является '111.11.11.112'.

  • Номером порта машины, запускающей процесс B-PIPE Bloomberg, является 8194.

c bloombergBPIPE объект.

authtype = 'OS_LOGON';
appname = '';
ipaddress = {'111.11.11.112'};
port = 8194;

c = bloombergBPIPE(authtype,appname,ipaddress,port);

Возвратите данные как таблицу путем установки DataReturnFormat свойство объекта связи. Если вы не устанавливаете это свойство, getbulkdata функция возвращает данные как структуру.

Даты возвращения как datetime массив путем установки DatetimeType свойство объекта связи. В этом случае таблица содержит даты в переменных, которые являются datetime массивы.

c.DataReturnFormat = 'table';
c.DatetimeType = 'datetime';

Возвратите историю дивиденда для IBM.

s = 'IBM US Equity';
f = 'DVD_HIST'; % Dividend history field

d = getbulkdata(c,s,f);

Отобразите первые три строки таблицы.

d.DVD_HIST{1}(1:3,:)
ans =

  3×7 table

        DeclaredDate              ExmDate                RecordDate             PayableDate         DividendAmount    DividendFrequency     DividendType 
    ____________________    ____________________    ____________________    ____________________    ______________    _________________    ______________

    31-Oct-2017 00:00:00    09-Nov-2017 00:00:00    10-Nov-2017 00:00:00    09-Dec-2017 00:00:00         1.5              'Quarter'        'Regular Cash'
    25-Jul-2017 00:00:00    08-Aug-2017 00:00:00    10-Aug-2017 00:00:00    09-Sep-2017 00:00:00         1.5              'Quarter'        'Regular Cash'
    25-Apr-2017 00:00:00    08-May-2017 00:00:00    10-May-2017 00:00:00    10-Jun-2017 00:00:00         1.5              'Quarter'        'Regular Cash'

Отобразите три заявленных даты. DeclaredDate переменной является datetime массив.

d.DVD_HIST{1}.DeclaredDate(1:3)
ans = 

  3×1 datetime array

   31-Oct-2017 00:00:00
   25-Jul-2017 00:00:00
   25-Apr-2017 00:00:00

Закройте связь Bloomberg.

close(c)

Входные параметры

свернуть все

Bloomberg связь B-PIPE в виде bloombergBPIPE объект.

Список безопасности в виде вектора символов или строкового скаляра для одной безопасности или массива ячеек из символьных векторов или массива строк для нескольких ценных бумаг. Можно задать безопасность по наименованию или CUSIP, и с или без источника оценки.

Типы данных: char | cell | string

Поля данных Bloomberg в виде вектора символов, строкового скаляра, массива ячеек из символьных векторов или массива строк. Вектор символов или строка обозначают одно имя поля данных Bloomberg. Массив ячеек из символьных векторов или массив строк обозначают несколько имен поля данных Bloomberg. Для получения дополнительной информации о полях можно задать, видеть, что Руководство разработчика API Bloomberg использует опцию WAPI <GO> от терминала Bloomberg.

Пример: {'LAST_PRICE';'OPEN'}

Типы данных: char | cell | string

Поле переопределения Bloomberg в виде вектора символов, строкового скаляра, массива ячеек из символьных векторов или массива строк. Вектор символов или строка обозначают одно имя поля переопределения Bloomberg. Массив ячеек из символьных векторов или массив строк обозначают несколько имен полей переопределения Bloomberg. Для получения дополнительной информации о полях можно задать, видеть, что Руководство разработчика API Bloomberg использует опцию WAPI <GO> от терминала Bloomberg.

Пример: 'END_DT'

Типы данных: char | cell | string

Значение поля переопределения Bloomberg в виде вектора символов, строкового скаляра, массива ячеек из символьных векторов или массива строк. Вектор символов или строка обозначают, что один Bloomberg заменяет значение поля. Массив ячеек из символьных векторов или массив строк обозначают несколько значений полей переопределения Bloomberg. Используйте это значение поля, чтобы отфильтровать набор результатов данных Bloomberg.

Пример: '20100101'

Типы данных: char | cell | string

Аргументы в виде пар имя-значение

Задайте дополнительные разделенные запятой пары Name,Value аргументы. Name имя аргумента и Value соответствующее значение. Name должен появиться в кавычках. Вы можете задать несколько аргументов в виде пар имен и значений в любом порядке, например: Name1, Value1, ..., NameN, ValueN.

Пример: 'returnFormattedValue',true

Дающие право идентификаторы в виде разделенной запятой пары, состоящей из 'returnEids' и булевская переменная. true добавляют имя и значение для дающего право идентификатора (EID) дата к данным о возврате.

Типы данных: логический

Возвратите формат в виде разделенной запятой пары, состоящей из 'returnFormattedValue' и булевская переменная. true силы все данные, которые будут возвращены как вектор символов типа данных.

Типы данных: логический

Формат даты/времени в виде разделенной запятой пары, состоящей из 'useUTCTime' и булевская переменная. true возвращает значения даты и времени как Всемирное координированное время (UTC) и false значения по умолчанию к настройкам Bloomberg TZDF <GO> просителя.

Типы данных: логический

Последние справочные данные в виде разделенной запятой пары, состоящей из 'forcedDelay' и булевская переменная. true возвращает последние данные до времени задержки, заданного обменом для безопасности.

Типы данных: логический

Выходные аргументы

свернуть все

Данные Bloomberg, возвращенные как структура, таблица или расписание. Тип данных данных Bloomberg зависит от свойств DataReturnFormat и DatetimeType объекта связи. Для получения дополнительной информации о данных, см., что Руководство разработчика API Bloomberg использует опцию WAPI <GO> от терминала Bloomberg.

Список безопасности, возвращенный как массив ячеек из символьных векторов для соответствующих ценных бумаг в s. Содержимое sec идентичны в значении и заказывают s. Можно возвратить ценные бумаги с любым из следующих идентификаторов:

  • buid

  • cats

  • cins

  • common

  • cusip

  • isin

  • sedol1

  • sedol2

  • sicovam

  • svm

  • ticker (значение по умолчанию)

  • wpk

Введенный в R2021a