function varargout = getCoverageInfo(varargin)
%getCoverageInfo - Coverage information for a model object
%
%   COVERAGE = getCoverageInfo(DATA, BLOCK, METRIC) Find test objective
%   defined by metric METRIC  for BLOCK within the cvdata coverage object DATA.
%   COVERAGE is returned as a 2 element vector: [covered_outcomes total_outcomes].
%   If information about BLOCK is not part of DATA then COVERAGE is empty.
%
%   The BLOCK parameter that specifies the model object can take
%   the following forms:
%
%       BlockPath           - Full path to a Simulink block or model
%       BlockHandle         - Simulink block or model handle
%       SimulinkObj         - Simulink object API handle.
%       StateflowID         - Stateflow ID (Should be from a singly
%                             instantiated chart.)
%       StateflowObj        - Stateflow object API handle. (Should be
%                             from a singly instantiated chart.)
%      {BlockPath, sfID}    - Cell array with the path to a Stateflow block
%                             and the ID of an object contained in that
%                             chart instance.
%      {BlockPath, sfObj}   - Path to a Stateflow block and a Stateflow
%                             object API handle contained in that chart.
%      [BlockHandle sfID]   - Array with a Stateflow block handle and the
%                             ID of an object contained in that chart
%                             instance.
%
%   COVERAGE = getCoverageInfo(DATA, BLOCK, METRIC, IGNORE_DESCENDANTS)
%   Find coverage information for BLOCK and ignore the coverage
%   in descendant objects if IGNORE_DESCENDANTS is true.
%
%   [COVERAGE,DESCRIPTION] = getCoverageInfo(DATA, BLOCK) Find the
%   coverage and produce a structured description of the test objectives
%   within BLOCK.  DESCRIPTION is a structure
%   containing textual descriptions of each test objective and descriptions
%   and execution counts for each outcome within BLOCK.
%
%   see also COMPLEXITYINFO, CONDITIONINFO, DECISIONINFO, EXECUTIONINFO,
%   MCDCINFO, OVERFLOWSATURATIONINFO, RELATIONALBOUNDARYINFO, SIGRANGEINFO,
%   SIGSIZEINFO, TABLEINFO.

%   Copyright 2009-2016 The MathWorks, Inc.

try
    [varargout{1:nargout}] = SlCov.CoverageAPI.getCoverageInfo(varargin{1:nargin});
catch Me
    throwAsCaller(Me);
end
