exponenta event banner

matlab.codetools.requiredFilesAndProducts

Список зависимостей программных файлов MATLAB

Описание

пример

fList = matlab.codetools.requiredFilesAndProducts(files) возвращает список программных файлов MATLAB ®, необходимых для выполнения программных файлов, указанных вfiles.

matlab.codetools.requiredFilesAndProducts функция предназначена для предоставления информации, передаваемой потребителям файлов программы MATLAB.

пример

[fList, pList] = matlab.codetools.requiredFilesAndProducts(files) также возвращает список продуктов MathWorks ®, которые могут потребоваться для запуска программных файлов, указанных вfiles.

Если вы используете matlab.codetools.requiredFilesAndProducts функция на полученном коде MATLAB, plist включает в себя только необходимые панели инструментов, установленные в системе. В этом случае plist может быть неполным.

пример

[fList, pList] = matlab.codetools.requiredFilesAndProducts(___,'toponly') указывает, что для включения файла или продукта в выходные данные он должен использоваться непосредственно, по крайней мере, одним файлом, указанным в files. 'toponly' параметр ввода не учитывает регистр.

Примеры

свернуть все

Определите необходимые файлы и продукты для edge в Toolbox™ Обработка изображений.

[fList,pList] = matlab.codetools.requiredFilesAndProducts('edge.m')
fList = 

     {}


pList = 

1x2 struct array with fields:

    Name
    Version
    ProductNumber
    Certain

Нет необходимых файлов MATLAB, но есть два обязательных продукта.

Перечислите необходимые продукты.

{pList.Name}'
ans = 

    'MATLAB'
    'Image Processing Toolbox'

В текущей рабочей папке создайте функцию в файле getRandomNumber.m.

function a = getRandomNumber
    rng shuffle
    a = rand;
end

Теперь в командной строке определите необходимые файлы и продукты для getRandomNumber.m.

[fList,pList] = matlab.codetools.requiredFilesAndProducts('getRandomNumber.m')
fList = 

    'C:\work\getRandomNumber.m'


pList = 

             Name: 'MATLAB'
          Version: '8.5'
    ProductNumber: 1
          Certain: 1

Единственный файл, необходимый для запуска getRandomNumber функция - это сам файл функции. Единственным обязательным продуктом MathWorks является MATLAB.

В текущей рабочей папке создайте функцию в файле displayNumber.m.

function displayNumber
    a = getRandomNumber;
    disp(['Your number is ' num2str(a)])
end

Теперь в командной строке определите необходимые файлы и продукты для displayNumber.m.

[fList,pList] = matlab.codetools.requiredFilesAndProducts('displayNumber.m')
fList = 

    'C:\work\displayNumber.m'    'C:\work\getRandomNumber.m'


pList = 

             Name: 'MATLAB'
          Version: '8.5'
    ProductNumber: 1
          Certain: 1

В дополнение к самому файлу функции, displayNumber для функции требуется getRandomNumber.m файл. Единственным обязательным продуктом MathWorks является MATLAB.

В текущей рабочей папке создайте класс дескрипторов в файле ExampleHandle.m.

classdef ExampleHandle < handle
    % class content
end

В текущей рабочей папке создайте класс в файле AnotherExampleHandle.m который наследует от ExampleHandle.

classdef AnotherExampleHandle < ExampleHandle
    % class content
end

В текущей рабочей папке создайте функцию в файле getHandles.m который создает экземпляр AnotherExampleHandle объекты.

function [h1,h2] = getHandles()
    h1 = AnotherExampleHandle;
    h2 = AnotherExampleHandle;
end

Теперь в командной строке определите необходимые файлы для getHandles.m.

[fList,~] = matlab.codetools.requiredFilesAndProducts('getHandles.m');
fList'
ans = 

    'C:\work\AnotherExampleHandle.m'
    'C:\work\ExampleHandle.m'
    'C:\work\getHandles.m'

Определите требуемые файлы, которые непосредственно требуются для getHandles.m.

[fList,~] = matlab.codetools.requiredFilesAndProducts('getHandles.m','toponly')
fList = 

    'C:\work\AnotherExampleHandle.m'    'C:\work\getHandles.m'

Хотя AnotherExampleHandle.m требует ExampleHandle.m, этот файл не является прямым требованием для getHandles.m.

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

свернуть все

Список файлов для анализа, указанный как символьный вектор, массив ячеек символьных векторов или строковый массив. Каждый элемент является именем одного файла программы MATLAB. Например, files список программных файлов MATLAB, которые вы собираетесь предоставить другим пользователям. matlab.codetools.requiredFilesAndProducts функция предоставляет информацию о требованиях для передачи вместе с файлами.

Для обеспечения точного отчета о зависимостях files зависимости должны находиться в пути MATLAB. matlab.codetools.requiredFilesAndProducts не возвращает информацию о зависимых файлах, не указанных в пути.

Пример: 'myFile.m' или "C:\Program Files\MATLAB\R2014a\my_work\myFile.m"

Пример: {'myFile.m','myOtherFile.m'}

Пример: cellstr(ls('*.m'))

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

свернуть все

Список пользовательских программных файлов MATLAB, необходимых для files, возвращается в виде массива ячеек символьных векторов. Каждый символьный вектор указывает полный путь к требуемому файлу. fList не включает встроенные файлы MATLAB, поскольку эти файлы устанавливаются вместе с продуктами, перечисленными в pList.

fList включает зависимые файлы, доступ к которым осуществляется с использованием стандартного формата файлов и низкоуровневых функций ввода-вывода. Эти зависимые файлы включают текстовые файлы, электронные таблицы, изображения, аудио, видео и XML-файлы. Например, при анализе файла, содержащего код load('mydata.mat'), matlab.codetools.requiredFilesAndProducts функция включает mydata.mat в fList.

Функции, поддерживающие автоматическое обнаружение зависимых файлов, включают audioinfo, audioread, csvread, daqread, dlmread, fileread, fopen, imfinfo, importdata, imread, load, matfile, mmfileinfo, open, readtable, type, VideoReader, xlsfinfo, xlsread, xmlread, и xslt.

Список продуктов MathWorks, которые могут потребоваться files, возвращается в виде структуры или массива структур. Каждый продукт описывается по наименованию (Name поле), версия (Version поле), номер продукта (ProductNumber поле) и индикатор определенности (Certain поле). Certain поле имеет значение 1, если matlab.codetools.requiredFilesAndProducts определяет продукт, необходимый для указанных программных файлов, filesили значение 0, если возможно требуется продукт.

matlab.codetools.requiredFilesAndProducts функция предназначена для предоставления информации, передаваемой потребителям файлов программы MATLAB. Номера версий указывают версию продуктов, установленных при выполнении функции. Version не является индикатором обратной совместимости.

Представлен в R2014a