Scilab Website | Contribute with GitLab | Mailing list archives | ATOMS toolboxes
Scilab Online Help
6.0.1 - Русский

Change language to:
English - Français - 日本語 - Português -

Please note that the recommended version of Scilab is 2025.0.0. This page might be outdated.
See the recommended documentation of this function

Справка Scilab >> CACSD > Linear Analysis > Frequency Domain > phaseplot

phaseplot

frequency phase plot

Syntax

phaseplot(sl)
phaseplot(sl,fmin,fmax [,step] [,comments] )
phaseplot(frq,db,phi [,comments])
phaseplot(frq, repf [,comments])

Arguments

sl

a single input multiple output (SIMO) linear dynamical system (see syslin).

fmin

real scalar: the minimum frequency (in Hz) to be represented.

fmax

real scalar: the maximum frequency (in Hz) to be represented.

step

real scalar: the frequency discretization step (logarithmic scale)). If it is not specified the algorithm uses adaptative frequency steps.

comments

a character string vector: the legend label to be associated with each curve. Optional value is the empty array.

frq

a row vector or an n x m array: The frequency discretization in Hz.

db

an n x m array: the magnitudes corresponding to frq. This argument is not used, it only appears to make phaseplot have the same syntax as gainplot and bode.

phi

an n x m array: the phases in degree corresponding to frq. The phaseplot function plots the curves phi(i,:) versus frq(i,:)

repf

an n x m complex array. The phaseplot function plots the curves phase(repf(i,:)) versus frq(i,:)

Description

This function draws the phase of the frequency response of a system. The system can be given under different representations:

  • phaseplot(sl,...) case

    sl can be a continuous-time or discrete-time SIMO system (see syslin). In case of multi-output the outputs are plotted with different symbols.

    In this case the frequencies can be given by:

    • the lower and upper bounds in Hz fmin, fmax and an optional frequency step step. The default values for fmin and fmaxare 1.e-3, 1.e3 if sl is continuous-time or 1.e-3, 0.5/sl.dt (nyquist frequency) if sl is discrete-time. If the step argument is omitted the function use an adaptative frequency step (see calfrq).

    • a row vector or a 2D array frq which gives the frequency values in Hz. 2D array can be used for multi-output systems if one wants to have different frequency discretization for each input/output couple.

  • phaseplot(frq,...) case

    This case allows to draw frequency phase plots for previously computed frequency responses. The frequency response can be given either by it's complex representation repf or by it's magnitude phase representation db, phi.

    frq and repf must be row vectors or n x m arrays (each row represent an input/output couple).

The datatips tool may be used to display data along the phase curves.

Examples

s=poly(0,'s')
h1=syslin('c',(s^2+2*0.9*10*s+100)/(s^2+2*0.3*10.1*s+102.01))
h2=syslin('c',(s^2+2*0.1*15.1*s+228.01)/(s^2+2*0.9*15*s+225))
clf();phaseplot([h1;h2],0.01,100,..
                   ["$\frac{s^2+18 s+100}{s^2+6.06 s+102.1}$";
                    "$\frac{s^2+3.02 s+228.01}{s^2+27 s+225}$"])
title('Phaseplot')

See also

  • bode — Bode plot
  • gainplot — magnitude plot
  • repfreq — frequency response
  • calfrq — frequency response discretization
  • datatips — Tool for placing and editing tips along the plotted curves.

History

VersionDescription
5.4.0 Function phaseplot introduced.
Report an issue
<< phasemag Frequency Domain repfreq >>

Copyright (c) 2022-2024 (Dassault Systèmes)
Copyright (c) 2017-2022 (ESI Group)
Copyright (c) 2011-2017 (Scilab Enterprises)
Copyright (c) 1989-2012 (INRIA)
Copyright (c) 1989-2007 (ENPC)
with contributors
Last updated:
Mon Feb 12 20:08:36 CET 2018