Main Content

shortPeriodCategoryAPlot

Draw MIL-F-8785C short-period category A requirements plot

Since R2021b

Description

Basic Syntax and Line Specification

shortPeriodCategoryAPlot(nalpha,omega) plots vector omega versus vector nalpha. If nalpha or omega is a matrix, then the function plots the vector versus the rows or columns of the matrix, whichever are aligned. If nalpha is a scalar and omega is a vector, the function creates the disconnected line objects and plots them as discrete points vertically at nalpha. This function is based on the MATLAB® plot function.

shortPeriodCategoryAPlot(nalpha,omega,LineSpec) plots short-period category A requirements specified by the line specification LineSpec.

shortPeriodCategoryAPlot(nalpha1,omega1,LineSpec1,...nalphan,omegan,LineSpecn) combines the plots specified by the nalpha, omega, and linespec. It sets the line style, marker type, and color for each line. You can mix nalpha, omega, LineSpec triplets with nalpha, omega arguments, for example, plot(nalpha1,omega1,nalpha2,omega2,LineSpec2,nalpha3,omega3).

example

Name-Value Arguments and Axes Specification

shortPeriodCategoryAPlot(___,Name,Value) plots an altitude envelope contour specified by one or more Name,Value arguments. Specify name-value arguments after all other input arguments.

shortPeriodCategoryAPlot(ax,___) draws an altitude contour plot onto the axes ax. Specify arguments as previously listed after the ax argument.

example

Return Line Objects

[line,bline] = shortPeriodCategoryAPlot(___) returns a vector of line objects lineobjects and a vector of boundaryline objects boundary_lineobjects. Use lineobjects and boundary_lineobjects to modify properties of a specific plot after it is created. Specify arguments as previously listed.

example

Examples

collapse all

Plot the reference MIL-F-8785C short-period category A requirements.

shortPeriodCategoryAPlot([])

Figure contains an axes object. The axes object with title MIL-F-8785C Short-Period Frequency Requirements Category A Flight Phases, xlabel n/ alpha blank ~ blank g's/RAD, ylabel omega indexOf n indexOf SP baseline baseline blank ~ blank RAD/SEC contains 6 objects of type boundaryline. These objects represent Level 1, Level 2, Level 3, Level 2 & 3.

Plot nalpha and omega data against the level 1 short-period category A requirements using diamond markers.

nalpha = 1:10;
omega = rand(10)+1;
shortPeriodCategoryAPlot(nalpha,omega,"d","Level","1")

Figure contains an axes object. The axes object with title MIL-F-8785C Short-Period Frequency Requirements Category A Flight Phases, xlabel n/ alpha blank ~ blank g's/RAD, ylabel omega indexOf n indexOf SP baseline baseline blank ~ blank RAD/SEC contains 12 objects of type line, boundaryline. One or more of the lines displays its values using only markers This object represents Level 1.

Plot the reference MIL-F-8785C short-period category A requirements. Return line objects and boundary line objects in h and b.

[h,b] = shortPeriodCategoryAPlot([])

Figure contains an axes object. The axes object with title MIL-F-8785C Short-Period Frequency Requirements Category A Flight Phases, xlabel n/ alpha blank ~ blank g's/RAD, ylabel omega indexOf n indexOf SP baseline baseline blank ~ blank RAD/SEC contains 6 objects of type boundaryline. These objects represent Level 1, Level 2, Level 3, Level 2 & 3.

h = 
  0x1 empty Line array.

b = 
  6x1 BoundaryLine array:

  BoundaryLine    (Level 1)
  BoundaryLine    (Level 1)
  BoundaryLine    (Level 2)
  BoundaryLine    (Level 2)
  BoundaryLine    (Level 3)
  BoundaryLine    (Level 2 & 3)

Input Arguments

collapse all

Load factor per angle of attack n/α, specified as a scalar, vector, or matrix, in g's/radian.

Data Types: double

Short-period undamped natural frequency response ωnSP, specified as a scalar, vector, or matrix, in radians/second.

Data Types: double

Valid axes, specified as a scalar handle. By default, this function plots to the current axes, obtainable with the gca function.

Data Types: double

Line style, marker, and color, specified as a string scalar or character vector containing symbols. The symbols can appear in any order. You do not need to specify all three characteristics (line style, marker, and color). For example, if you omit the line style and specify the marker, then the plot shows only the marker and no line.

Example: "--or" is a red dashed line with circle markers.

Line StyleDescriptionResulting Line
"-"Solid line

Sample of solid line

"--"Dashed line

Sample of dashed line

":"Dotted line

Sample of dotted line

"-."Dash-dotted line

Sample of dash-dotted line, with alternating dashes and dots

MarkerDescriptionResulting Marker
"o"Circle

Sample of circle marker

"+"Plus sign

Sample of plus sign marker

"*"Asterisk

Sample of asterisk marker

"."Point

Sample of point marker

"x"Cross

Sample of cross marker

"_"Horizontal line

Sample of horizontal line marker

"|"Vertical line

Sample of vertical line marker

"square"Square

Sample of square marker

"diamond"Diamond

Sample of diamond marker

"^"Upward-pointing triangle

Sample of upward-pointing triangle marker

"v"Downward-pointing triangle

Sample of downward-pointing triangle marker

">"Right-pointing triangle

Sample of right-pointing triangle marker

"<"Left-pointing triangle

Sample of left-pointing triangle marker

"pentagram"Pentagram

Sample of pentagram marker

"hexagram"Hexagram

Sample of hexagram marker

Color NameShort NameRGB TripletAppearance
"red""r"[1 0 0]

Sample of the color red

"green""g"[0 1 0]

Sample of the color green

"blue""b"[0 0 1]

Sample of the color blue

"cyan" "c"[0 1 1]

Sample of the color cyan

"magenta""m"[1 0 1]

Sample of the color magenta

"yellow""y"[1 1 0]

Sample of the color yellow

"black""k"[0 0 0]

Sample of the color black

"white""w"[1 1 1]

Sample of the color white

Name-Value Arguments

Specify optional pairs of arguments as Name1=Value1,...,NameN=ValueN, where Name is the argument name and Value is the corresponding value. Name-value arguments must appear after other arguments, but the order of the pairs does not matter.

Before R2021a, use commas to separate each name and value, and enclose Name in quotes.

Example: "Level","1"

Note

These properties are only a subset. For a full list, see Line Properties.

Requirement level to plot, specified as:

  • "All"

  • "1"

  • "2"

  • "3"

Data Types: double

Output Arguments

collapse all

One or more line objects, returned as a scalar or a vector. These are unique identifiers, which you can use to query and modify properties of a specific line. For a list of properties, see Line Properties.

One or more boundary line objects, returned as a scalar or a vector. These are unique identifiers, which you can use to query and modify properties of a specific chart line. For a list of properties, see Line Properties.

Version History

Introduced in R2021b