blp

Связь Рабочего стола Bloomberg V3

расширьте все на странице

Описание

Функция blp создает объект blp. Объект blp представляет связь Bloomberg® Desktop.

Другие функции соединяются с различными сервисами Bloomberg: Сервер Bloomberg (blpsrv), Bloomberg B-PIPE® (bpipe) и Лицензия Данных Bloomberg (bdl). Для получения дополнительной информации об этих сервисах, смотрите Сравнение Связей Bloomberg.

Для получения дополнительной информации о требованиях связи Bloomberg, смотрите Требования Связи Сервера данных. Чтобы гарантировать успешную связь Bloomberg, выполните необходимые шаги прежде, чем выполнить blp. Для получения дополнительной информации смотрите Установку Bloomberg и Конфигурирование Связей.

Создание

Синтаксис

c = blp
c = blp(port,ip,timeout)

Описание

пример

c = blp создает объект связи Bloomberg, который содержит связь Рабочего стола Bloomberg. Вам нужна лицензия Программного обеспечения, установленного на компьютере Bloomberg на машину, запускающую Datafeed Toolbox™ и MATLAB®.

пример

c = blp(port,ip,timeout) устанавливает Порт и Свойства Timeout, и использует IP-адрес локального выполнения машины Bloomberg, чтобы создать связь Bloomberg.

Внимание:

Чтобы относиться к связи Bloomberg в других функциях, используйте объект связи, созданный функцией blp. В противном случае с помощью blp, когда входной параметр открывает несколько связей Bloomberg, вызывая неожиданное поведение и исчерпывая ресурсы памяти.

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

развернуть все

IP-адрес, который идентифицирует локальное выполнение машины Bloomberg, заданный как скаляр строки или вектор символов.

Пример: 'localhost'

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

Свойства

развернуть все

Это свойство доступно только для чтения.

Сеанс Bloomberg V3, заданный как объект Bloomberg V3 API Session.

Пример: [1x1 com.bloomberglp.blpapi.Session]

Номер порта локального выполнения машины Bloomberg, заданный в виде числа.

Пример: 8194

Типы данных: double

IP-адрес локального выполнения машины Bloomberg, заданный как вектор символов.

Функция blp устанавливает это свойство с помощью входного параметра ip.

Пример: 'localhost'

Типы данных: char

Тайм-аут, задающий время в миллисекундах, которые MATLAB пытается соединить с Рабочим столом Bloomberg перед таймаутом, заданным в виде числа.

Пример: 10000

Типы данных: double

Тип данных даты и времени, заданный как одно из этих значений.

ЗначениеОписание
'' (значение по умолчанию)Дата возвращения и временные стоимости как числа даты MATLAB.
'datetime'Дата возвращения и временные стоимости как массив datetime.

Можно задать эти значения с помощью вектора символов или строки (например, "datetime").

Когда вы создаете объект blp, функция blp оставляет этот сброс свойства. Чтобы получить данные, необходимо установить это значение свойства вручную в командной строке или в скрипте с помощью записи через точку, например: 

c.DatetimeType = 'datetime';
Затем можно использовать эти поддерживаемые функции:

  • getbulkdata

  • getdata

  • history

  • tahistory

  • timeseries

    Примечание

    Если значением свойства DataReturnFormat является 'table', и значением свойства DatetimeType является 'datetime', то возвращенные данные являются таблицей, которая содержит значения даты и времени как массив datetime. Если значение свойства DataReturnFormat является пустым символьным вектором, то установка свойства DatetimeType к 'datetime' возвращает значения даты и времени для агрегированных меток деления и исторических запросов как числа даты MATLAB.

Данные возвращают формат, заданный как одно из этих значений, которые определяют тип данных возвращенных данных.

ЗначениеТип данных возвращенных данных
'cell'cell array
'table'table
'timetable'timetable
'structure'structure

Примечание

Тип данных по умолчанию возвращенных данных зависит от выполняемой функции. Чтобы задать тип данных по умолчанию, установите свойство DataReturnFormat на ''. Для типов данных по умолчанию см. поддерживаемый функциональный список.

Можно задать эти значения с помощью вектора символов или строки (например, "table").

Когда вы создаете объект blp, функция blp оставляет этот сброс свойства. Чтобы получить данные, необходимо установить это значение свойства вручную в командной строке или в скрипте с помощью записи через точку, например: 

c.DataReturnFormat = 'structure';
Затем можно использовать эти поддерживаемые функции.

Поддерживаемая функцияДопустимые типы данных для возвращенных данных
category

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

  • structure

  • table

eqs

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

  • structure

  • table

fieldinfo

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

  • structure

  • table

fieldsearch

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

  • structure

  • table

lookup

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

  • table

portfolio

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

  • table

getbulkdata

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

  • table

  • timetable

getdata

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

  • table

  • timetable

history

  • числовой массив (значение по умолчанию)

  • table

  • timetable

tahistory

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

  • table

  • timetable

timeseries

  • cell array (значение по умолчанию для необработанных тиковых данных)

  • числовой массив (значение по умолчанию для тиковых данных интервала)

  • table

  • timetable

Примечание

Независимо от значения свойства DatetimeType, если значением свойства DataReturnFormat является 'timetable', то getdata и функции getbulkdata возвращают таблицу, которая содержит значения даты и времени как массивы datetime.

Функции объекта

развернуть все

closeЗакройте связь Bloomberg V3
getСвойства связи Bloomberg V3
isconnectionОпределите связь Bloomberg V3
eqsДанные об экранировании акции для связи Bloomberg V3
getbulkdataОбъемные данные с информацией о заголовке для связи Bloomberg V3
getdataТекущие данные для связи Bloomberg V3
historyИсторические данные для связи Bloomberg V3
portfolioТекущие данные о портфеле для связи Bloomberg V3
realtimeДанные реального времени для связи Bloomberg V3
stopОтпишите запросы в реальном времени о связи Bloomberg V3
tahistoryИсторический технический анализ для связи Bloomberg V3
timeseriesСуточные тиковые данные для связи Bloomberg V3
categoryПолевая категория ищет связь Bloomberg V3
fieldinfoИнформация о поле для связи Bloomberg V3
fieldsearchПолевой поиск связи Bloomberg V3
lookupНайдите информацию о ценных бумагах для связи Bloomberg V3

Примеры

свернуть все

Скрипт Open Live Script

Во-первых, создайте связь Bloomberg®, и затем получите текущие данные для безопасности.

Создайте связь с Рабочим столом Bloomberg. 

c = blp
c = 
  blp with properties:

             Session: [1×1 com.bloomberglp.blpapi.Session]
           IPAddress: 'localhost'
                Port: 8194
             TimeOut: 0
        DatetimeType: ''
    DataReturnFormat: ''

c является объектом связи Bloomberg с этими свойствами:

  • Объект Bloomberg V3 API Session

  • IP-адрес локальной машины

  • Номер порта локальной машины

  • Номер в миллисекундах, задающих, сколько времени MATLAB пытается соединиться с Рабочим столом Bloomberg перед таймаутом

  • Тип данных даты и времени

  • Данные возвращают формат

Запросите последние и цены открытия за Microsoft®.

format bank % Display data format for currency
s = 'MSFT US Equity';
f = {'LAST_PRICE';'OPEN'};
[d,sec] = getdata(c,s,f)
d = struct with fields:
    LAST_PRICE: 72.28
          OPEN: 71.61


sec = 1×1 cell array
    {'MSFT US Equity'}

getdata возвращает структуру d с последними и ценами открытия. Кроме того, getdata возвращает безопасность в sec.

Закройте связь Рабочего стола Bloomberg.

close(c)
Скрипт Open Live Script

Во-первых, создайте связь Bloomberg® со значением тайм-аута, и затем получите текущие данные для безопасности.

Создайте связь с Рабочим столом Bloomberg использование порта по умолчанию и IP-адреса. Задайте значение тайм-аута 10 000 миллисекунд. 

c = blp([],[],10000)
c = 
  blp with properties:

             Session: [1×1 com.bloomberglp.blpapi.Session]
           IPAddress: 'localhost'
                Port: 8194
             TimeOut: 10000
        DatetimeType: ''
    DataReturnFormat: ''

Функция blp создает объект c связи Bloomberg с этими свойствами:

  • Объект Bloomberg V3 API Session

  • IP-адрес локальной машины

  • Номер порта локальной машины

  • Количество миллисекунд, задающих, сколько времени MATLAB® пытается соединиться с Рабочим столом Bloomberg перед таймаутом

  • Тип данных даты и времени

  • Данные возвращают формат

Запросите последние и цены открытия за Microsoft®.

format bank % Display data format for currency
s = 'MSFT US Equity';
f = {'LAST_PRICE';'OPEN'};
[d,sec] = getdata(c,s,f)
d = struct with fields:
    LAST_PRICE: 71.83
          OPEN: 71.61


sec = 1×1 cell array
    {'MSFT US Equity'}

getdata возвращает структуру d с последними и ценами открытия. Кроме того, getdata возвращает безопасность в sec.

Закройте связь Рабочего стола Bloomberg.

close(c)

Смотрите также

Темы

Представленный в R2010a

Документация Datafeed Toolbox
Поддержка
Для просмотра документации необходимо авторизоваться на сайте