Home > voicebox > xticksi.m

# xticksi

## PURPOSE

XTIXKSI labels the x-axis of a plot using SI multipliers S=(AH)

## SYNOPSIS

function s=xticksi(ah)

## DESCRIPTION

```XTIXKSI labels the x-axis of a plot using SI multipliers S=(AH)

Inputs:  AH       axis handle [default: current axes]

Outputs:  S        optional global SI multiplier (see usage below)

Usage:   (1) plot(...);
xticksi;

(2) plot(...);
xlabel(['Frequency (' xticksi 'Hz)']);

The first form will label the tick marks on the x-axis of the current plot
using SI multipliers where appropriate. This is particularly useful for log
plots which MATLAB does not label very well.
The second form will, if possible, use a single SI multiplier for all the tick
marks; this global multiplier can be incorporated into the axis label as shown.```

## CROSS-REFERENCE INFORMATION

This function calls:
• xyzticksi XYZTIXKSI labels an axis of a plot using SI multipliers S=(AX,AH)
This function is called by:
• cent2frq FRQ2ERB Convert Hertz to Cents frequency scale [C,CR]=(FRQ)
• correlogram make correlogram,
• erb2frq ERB2FRQ Convert ERB frequency scale to Hertz FRQ=(ERB)
• filtbankm FILTBANKM determine matrix for a linear/mel/erb/bark-spaced filterbank [X,IL,IH]=(P,N,FS,FL,FH,W)
• frq2bark FRQ2BARK Convert Hertz to BARK frequency scale BARK=(FRQ)
• frq2cent FRQ2ERB Convert Hertz to Cents frequency scale [C,CR]=(FRQ)
• frq2erb FRQ2ERB Convert Hertz to ERB frequency scale ERB=(FRQ)
• frq2mel FRQ2ERB Convert Hertz to Mel frequency scale MEL=(FRQ)
• gammabank GAMMABANK gammatone filter bank [b,a,fx,bx,gd]=(n,fs,w,fc,bw,ph,k)
• mel2frq MEL2FRQ Convert Mel frequency scale to Hertz FRQ=(MEL)
• melbankm MELBANKM determine matrix for a mel/erb/bark-spaced filterbank [X,MN,MX]=(P,N,FS,FL,FH,W)
• sone2phon PHON2SONE convert SONE loudness values to PHONs p=(s)
• spgrambw SPGRAMBW Draw spectrogram [T,F,B]=(s,fs,mode,bw,fmax,db,tinc,ann)
• stdspectrum STDSPECTRUM Generate standard acoustic/speech spectra in s- or z-domain [B,A,SI,SN]=(S,M,F,N,ZI,BS,AS)
• v_ppmvu V_PPMVU calculate PPM, VU or EBU level of an audio signal [V,FX,FX1]=(X,FSX,M)

## SOURCE CODE

```0001 function s=xticksi(ah)
0002 %XTIXKSI labels the x-axis of a plot using SI multipliers S=(AH)
0003 %
0004 %  Inputs:  AH       axis handle [default: current axes]
0005 %
0006 % Outputs:  S        optional global SI multiplier (see usage below)
0007 %
0008 % Usage:   (1) plot(...);
0009 %              xticksi;
0010 %
0011 %          (2) plot(...);
0012 %              xlabel(['Frequency (' xticksi 'Hz)']);
0013 %
0014 % The first form will label the tick marks on the x-axis of the current plot
0015 % using SI multipliers where appropriate. This is particularly useful for log
0016 % plots which MATLAB does not label very well.
0017 % The second form will, if possible, use a single SI multiplier for all the tick
0018 % marks; this global multiplier can be incorporated into the axis label as shown.
0019
0020 %       Copyright (C) Mike Brookes 2009
0021 %      Version: \$Id: xticksi.m 713 2011-10-16 14:45:43Z dmb \$
0022 %
0023 %   VOICEBOX is a MATLAB toolbox for speech processing.
0025 %
0026 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
0027 %   This program is free software; you can redistribute it and/or modify
0029 %   the Free Software Foundation; either version 2 of the License, or
0030 %   (at your option) any later version.
0031 %
0032 %   This program is distributed in the hope that it will be useful,
0033 %   but WITHOUT ANY WARRANTY; without even the implied warranty of
0034 %   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
0035 %   GNU General Public License for more details.
0036 %
0037 %   You can obtain a copy of the GNU General Public License from
0038 %   http://www.gnu.org/copyleft/gpl.html or by writing to
0039 %   Free Software Foundation, Inc.,675 Mass Ave, Cambridge, MA 02139, USA.
0040 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
0041 if ~nargin
0042     ah=gca;
0043 end
0044 if nargout
0045 s=xyzticksi(1,ah);
0046 else
0047     xyzticksi(1,ah);
0048 end```

Generated on Mon 06-Aug-2018 14:48:32 by m2html © 2003