dBscale               package:seewave               R Documentation

_d_B _c_o_l_o_u_r _s_c_a_l_e _f_o_r _a _s_p_e_c_t_r_o_g_r_a_m _d_i_s_p_l_a_y

_D_e_s_c_r_i_p_t_i_o_n:

     This function displays a vertical or horizontal dB colour scale to
     be used with 'spectro' plots.

_U_s_a_g_e:

     dBscale(collevels, palette = spectro.colors, side = 4,
     textlab = "Amplitude\n(dB)", cexlab = 0.75,
     fontlab = 1, collab = "black", ...)

_A_r_g_u_m_e_n_t_s:

collevels: a set of levels which are used to partition the amplitude
          range of the spectrogram (in dB).

 palette: a color palette function to be used to assign colors in the
          plot, see 'note'.

    side: side of the axis.

 textlab: text of the label.

  cexlab: character size of the label.

 fontlab: font of the label.

  collab: colour of the label.

     ...: other 'axis' arguments.

_N_o_t_e:

     This function, based on 'filled.contour' by Ross Ihaka, is not
     supposed to be used by itself but as a legend of 'spectro'.
      Any colour palette can be used. In particular, it is possible to
     use other palettes coming with 'seewave': 'rev.heat.colors',
     'rev.terrain.colors','rev.topo.colors',  'rev.cm.colors'
     corresponding to the reverse of 'heat.colors',  'terrain.colors',
     'topo.colors', 'cm.colors'.

_A_u_t_h_o_r(_s):

     Jrme Sueur jerome.sueur@ibaic.u-psud.fr and  Caroline
     Simonis-Sueur csimonis@mnhn.fr.

_S_e_e _A_l_s_o:

     'spectro'.

_E_x_a_m_p_l_e_s:

     data(pellucens)
     # place the scale on the left and not on the right as spectro() does
     def.par <- par(no.readonly = TRUE)
     layout(matrix(c(1, 2), nc = 2), widths = c(1, 5))
     par(mar=c(5,3,4,2))
     dBscale(collevels=seq(-30,0,1),side=2)
     par(mar=c(5,4,4,2))
     spectro(pellucens, f=22050,wl=512,scale=FALSE)
     par(def.par)
     # place the scale on the top and not on the right as spectro() does
     def.par <- par(no.readonly = TRUE)
     layout(matrix(c(0,1,2,2), nc = 2, byrow=TRUE),widths=c(1,2),heights=(c(1,5.5)))
     par(mar=c(0.5,3,4,2))
     dBscale(collevels=seq(-30,0,1), textlab = "",side=3)
     mtext("Amplitude (dB)",side=2,line = 1,at=0.6,cex=0.75)
     par(mar=c(5,4,0.5,2))
     spectro(pellucens, f=22050,wl=512,scale=FALSE)
     par(def.par)   

