{"id":25170,"date":"2023-10-30T12:47:03","date_gmt":"2023-10-30T11:47:03","guid":{"rendered":"https:\/\/demdlx704as001.ad.harman.com\/?post_type=documentor-sections&p=25170"},"modified":"2024-04-18T16:29:40","modified_gmt":"2024-04-18T14:29:40","slug":"parameterbiquad-2-3","status":"publish","type":"post","link":"https:\/\/audioworx.transfunnel.co\/old\/?p=25170","title":{"rendered":"ParameterBiquad"},"content":{"rendered":"

This ParameterBiquad audio object computes bi-quadratic filter coefficients and calculates the output of the input audio buffers processed through the filters that users specify.<\/span><\/p>\n

Use Case:<\/strong> This audio object can be deployed whenever a user wants to filter a signal based on user specified parameters.<\/em><\/span><\/p>\n

Parameter Biquad Properties<\/strong><\/span><\/p>\n

Below table describes about object properties and functionality of ParameterBiquad audio object.<\/span><\/p>\n

<\/span><\/p>\n\n\n\n\n\n\n\n
Properties<\/strong><\/span><\/td>\nDescriptions<\/strong><\/span><\/td>\n<\/tr>\n
# of Channels<\/strong><\/span><\/td>\nThe object has a configurable number of channels. The number of audio inputs is always equal to the number of audio outputs. These channels are referred as subblocks. Filter has as many subblocks as number of channels and one additional subblock for Ramp characteristics.<\/span><\/p>\n
    \n
  • Range: 1 to 64<\/span><\/li>\n
  • By default, the number of channels is set to 1.<\/span><\/li>\n<\/ul>\n<\/td>\n<\/tr>\n
Number of biquads<\/strong><\/span><\/td>\nThe number of elements generally describes the number of filters requested by the user.<\/span><\/p>\n
    \n
  • For parameter and parameter one modes, this value is configurable between 1 and a 100 and is by default set to 1.<\/span><\/li>\n
  • For Parameter one control mode, this value is not configurable and is hardcoded to 1.<\/span><\/li>\n<\/ul>\n<\/td>\n<\/tr>\n
Display Name<\/strong><\/span><\/td>\nDisplay the name of the ParameterBiquad audio object in signal flow design. It can be changed based on the intended usage of the object.<\/span><\/td>\n<\/tr>\n
Object Mode<\/strong><\/span><\/td>\nParameterBiquad audio object operates in one of the three modes.<\/span><\/p>\n
    \n
  • Parameter<\/strong><\/span><\/li>\n
  • Parameter One<\/strong><\/span><\/li>\n
  • Parameter One Control Set<\/strong><\/span><\/li>\n<\/ul>\n<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n

    Mode<\/strong><\/span><\/p>\n

    The ParameterBiquad audio object operates in one of three modes and ramping is applicable in all modes:<\/span><\/p>\n\n\n\n\n\n\n\n
    Mode<\/strong><\/span><\/th>\nDescription<\/strong><\/span><\/th>\n<\/tr>\n<\/thead>\n
    \n

    Parameter<\/strong><\/span><\/p>\n

    (Default)<\/em><\/td>\n

    		\n

    In this mode, the block receives the following filter specifications from the user for each filter in a channel.<\/span><\/p>\n

    This mode generates a set of filters per channel, so each channel has its own set of unique filters.<\/span><\/p>\n

      \n
    • Frequency (in Hz),<\/span><\/li>\n
    • Gain (in dB),<\/span><\/li>\n
    • Q (Quality factor), q<\/span><\/li>\n
    • Type of filter (lowpass, highpass, etc.)<\/span><\/li>\n
    • Bypass mode (if set, the block doesn\u2019t filter the incoming audio buffer)<\/span><\/li>\n<\/ul>\n

      In this mode, each channel can have its own set of coefficients and filter specifications.<\/span><\/td>\n<\/tr>\n

    Parameter One<\/strong><\/span><\/td>\n\n

    In this mode, the block receives the following filter specifications from the user for each filter in a channel:<\/span><\/p>\n

    This mode generates a set of filter coefficients for all audio channels. The only difference between this mode and the Parameter mode is that this mode generates one set of coefficients for all channels as opposed to one set per channel.<\/span><\/p>\n

      \n
    • Frequency (in Hz),<\/span><\/li>\n
    • Gain (in dB),<\/span><\/li>\n
    • Q (-Quality factor), q<\/span><\/li>\n
    • Type of filter (lowpass, highpass, etc.)<\/span><\/li>\n
    • Bypass mode (if set, the block doesn\u2019t filter the incoming audio buffer)<\/span><\/li>\n<\/ul>\n

      In this mode, all channels use same set of filter\/filter coefficients. This block uses the above filter specifications to calculate the filter coefficients based on the type of the filter requested by the user.<\/span><\/p>\n

      The difference between Parameter mode and Parameter One mode is that Parameter One mode will apply the same set of filter coefficients to each channel whereas Parameter mode will apply different sets for different channels.<\/span><\/p>\n

      This is identical to the Parameter Mode, except, instead of presenting the variables for each filter per channel, this mode only presents a set of coefficients per filter, regardless of the number of channels.<\/span><\/td>\n<\/tr>\n

    Parameter One Control Set<\/strong><\/span><\/td>\n\n

    This mode also allows to control the cut off frequency via a control input pin.<\/span><\/p>\n

    This mode only uses one filter and applies the filter characteristics to all channels similar to Parameter One mode. It also exposes one control (accessible from the HU) variable to manipulate the cut-off frequency.<\/span><\/p>\n

    This is identical to Parameter One Mode but it has only one filter.
    \nThe\u00a0Biquad\u00a0object does not expose any variables for control except for the\u00a0Parameter One Mode Set Control Frequency, where it exposes the cut-off frequency of the filter. When this parameter is changed then ramping is applied.<\/span><\/p>\n

    In addition to the above parameters, ParameterBiquad also exposes Ramp time configuration (both in state and tuning memory). For each channel in parameter mode and in Parameter One & Parameter One Mode Set Control Frequency single Ramp Time is exposed irrespective of number of channels.<\/span><\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n

    Additional Parameters<\/strong><\/span><\/p>\n\n\n\n\n\n
    Parameter<\/strong><\/span><\/td>\nDescription<\/strong><\/span><\/td>\n<\/tr>\n
    Biquad Topology<\/strong><\/span><\/td>\nAllows the user to choose the filter topology at design time.<\/span><\/p>\n
      \n
    • Direct Form I (DFI)<\/span><\/li>\n
    • Direct Form II (DFII)<\/span><\/li>\n
    • Transposed Direct Form II (TDFII)<\/span><\/li>\n<\/ul>\n

      By default, it is configured for DFII.<\/span><\/td>\n

    		<\/span><\/td>\n<\/tr>\n
    Tune Ramping On\/Off<\/strong><\/span><\/td>\n\n

    Allows user to enable or disable the ramping during tuning.<\/span><\/p>\n

    By default, ramping is disabled.<\/span><\/p>\n

    1 – Ramping Enable<\/span><\/p>\n

    0 – Ramping Disable<\/span><\/p>\n

    Irrespective of this option, ramping characteristics are always available as tuning parameters that will be used whenever changes are made through control inputs.<\/span><\/td>\n

    		<\/span><\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n

    Tuning Parameters<\/strong><\/span><\/p>\n

    This table assumes subblocks are utilized. If a user were to tune without subblocks, they would need to account for the memory offsets for subblocks.<\/p>\n

    f = Filter # (starting from beginning of subblock)<\/em><\/p>\n\n\n\n\n\n\n\n\n\n
    Parameter<\/strong><\/span><\/th>\nDescription<\/strong><\/span><\/th>\nData Type<\/strong><\/span><\/th>\nUnit<\/strong><\/span><\/th>\nDefault<\/strong><\/span><\/th>\nMemory Offset<\/strong><\/span><\/th>\nRange<\/strong><\/span><\/th>\n<\/tr>\n<\/thead>\n
    Frequency <\/strong><\/span><\/td>\nCut off frequency of the filter<\/span><\/td>\nfloat<\/span><\/td>\nHz<\/span><\/td>\n20<\/span><\/td>\nf * 5 * 4 + 0<\/span><\/td>\n10 to 20000<\/span><\/td>\n<\/tr>\n
    Gain<\/strong><\/span><\/td>\nGain<\/span><\/td>\nfloat<\/span><\/td>\ndB<\/span><\/td>\n0<\/span><\/td>\nf * 5 * 4 + 4<\/span><\/td>\n-30 to 50<\/span><\/td>\n<\/tr>\n
    Quality<\/strong><\/span><\/td>\nQ factor of the filter<\/span><\/td>\nfloat<\/span><\/td>\n–<\/span><\/td>\n0.7<\/span><\/td>\nf * 5 * 4 + 8<\/span><\/td>\n0.1 to 116<\/span><\/td>\n<\/tr>\n
    Type<\/strong><\/span><\/td>\nType of filter: lowpass\/high pass\/ shelve, etc<\/span><\/td>\nInt<\/span><\/td>\n–<\/span><\/td>\n0<\/span><\/td>\nf * 5 * 4 + 12<\/span><\/td>\n\n

    0 – BYPASS<\/span><\/p>\n

    15 – RESON<\/span><\/td>\n<\/tr>\n

    Bypass*<\/strong><\/span><\/td>\nBypass on or off (0 is on)<\/span><\/td>\nInt<\/span><\/td>\n–<\/span><\/td>\n0<\/span><\/td>\nf * 5 * 4 + 16<\/span><\/td>\n0 to 1<\/span><\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n

    *ATTENTION: The Bypass logic is inverted. When Bypass value is set to 1, the AO applies filtering and generates the filtered output. When Bypass value is set to 0, the AO passes the input to the output. This need to be retained this way to maintain backward compatibility.<\/em><\/span><\/p>\n

    Last subblock irrespective of channels will be the ramp characteristics. Below is the memory layout for the last subblock. If m_NumChannels <\/em>N,<\/span><\/p>\n

      \n
    • In Parameter mode last subblock will be N.<\/span><\/li>\n
    • \n
        \n
      • For example, for 2 channels, subblock 0 and 1 are for the filters and subblock 2 is for ramp characteristics. When channels are changed to 3 channels, subblock 0, 1 and 2 are for the filters and subblock 3 is ramp characterics.<\/span>\n
          \n
        • Please note that subblock 2 (which was used for ramp characteristics when number of channels were 2) used for filter when number of channels are 3.<\/span><\/li>\n
        • Because of this, application using this AO, may not be able to retain the ramp characters when number of channels are changed.<\/span><\/li>\n<\/ul>\n<\/li>\n<\/ul>\n<\/li>\n
        • In Parameter One mode and Parameter One control set mode last subblock will be 2 irrespective of number of channels<\/span><\/li>\n<\/ul>\n

          Ramp Characteristics Subblock<\/span><\/strong><\/p>\n\n\n\n\n\n\n
          Last sub-block<\/strong><\/span><\/td>\nName<\/strong><\/span><\/td>\nType<\/strong><\/span><\/td>\nUnit<\/strong><\/span><\/td>\nMin<\/strong><\/span><\/td>\nMax<\/strong><\/span><\/td>\nDefault Value<\/strong><\/span><\/td>\nOffset<\/strong><\/span><\/td>\nDescription<\/strong><\/span><\/td>\n<\/tr>\n
          Ch = 0<\/span><\/td>\nRamp time ch0<\/span><\/td>\nfloat<\/span><\/td>\nms<\/span><\/td>\n0<\/span><\/td>\n500<\/span><\/td>\n0<\/span><\/td>\nch *4<\/span><\/td>\nRamp time for first channel<\/span><\/td>\n<\/tr>\n
          Ch = 1<\/span><\/td>\nRamp time ch1<\/span><\/td>\nfloat<\/span><\/td>\nms<\/span><\/td>\n0<\/span><\/td>\n500<\/span><\/td>\n0<\/span><\/td>\nch * 4<\/span><\/td>\nRamp time for second channel<\/span><\/td>\n<\/tr>\n
          Ch = N\u00a0 – 1<\/span><\/td>\nRamp time ch(N-1)<\/span><\/td>\nfloat<\/span><\/td>\nms<\/span><\/td>\n0<\/span><\/td>\n500<\/span><\/td>\n0<\/span><\/td>\nch * 4<\/span><\/td>\nRamp time for last channel<\/span><\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n

          Control Parameters<\/strong><\/span><\/p>\n

          There are no control parameters available for Parameter Biquad audio object<\/span>.<\/p>\n","protected":false},"excerpt":{"rendered":"

          This ParameterBiquad audio object computes bi-quadratic filter coefficients and calculates the output of the input audio buffers processed through the filters that users specify. Use Case: This audio object can be deployed whenever a user wants to filter a signal based on user specified parameters. Parameter Biquad Properties Below table describes about object properties and […]<\/p>\n","protected":false},"author":107,"featured_media":0,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"ocean_post_layout":"","ocean_both_sidebars_style":"","ocean_both_sidebars_content_width":0,"ocean_both_sidebars_sidebars_width":0,"ocean_sidebar":"0","ocean_second_sidebar":"0","ocean_disable_margins":"enable","ocean_add_body_class":"","ocean_shortcode_before_top_bar":"","ocean_shortcode_after_top_bar":"","ocean_shortcode_before_header":"","ocean_shortcode_after_header":"","ocean_has_shortcode":"","ocean_shortcode_after_title":"","ocean_shortcode_before_footer_widgets":"","ocean_shortcode_after_footer_widgets":"","ocean_shortcode_before_footer_bottom":"","ocean_shortcode_after_footer_bottom":"","ocean_display_top_bar":"default","ocean_display_header":"default","ocean_header_style":"","ocean_center_header_left_menu":"0","ocean_custom_header_template":"0","ocean_custom_logo":0,"ocean_custom_retina_logo":0,"ocean_custom_logo_max_width":0,"ocean_custom_logo_tablet_max_width":0,"ocean_custom_logo_mobile_max_width":0,"ocean_custom_logo_max_height":0,"ocean_custom_logo_tablet_max_height":0,"ocean_custom_logo_mobile_max_height":0,"ocean_header_custom_menu":"0","ocean_menu_typo_font_family":"0","ocean_menu_typo_font_subset":"","ocean_menu_typo_font_size":0,"ocean_menu_typo_font_size_tablet":0,"ocean_menu_typo_font_size_mobile":0,"ocean_menu_typo_font_size_unit":"px","ocean_menu_typo_font_weight":"","ocean_menu_typo_font_weight_tablet":"","ocean_menu_typo_font_weight_mobile":"","ocean_menu_typo_transform":"","ocean_menu_typo_transform_tablet":"","ocean_menu_typo_transform_mobile":"","ocean_menu_typo_line_height":0,"ocean_menu_typo_line_height_tablet":0,"ocean_menu_typo_line_height_mobile":0,"ocean_menu_typo_line_height_unit":"","ocean_menu_typo_spacing":0,"ocean_menu_typo_spacing_tablet":0,"ocean_menu_typo_spacing_mobile":0,"ocean_menu_typo_spacing_unit":"","ocean_menu_link_color":"","ocean_menu_link_color_hover":"","ocean_menu_link_color_active":"","ocean_menu_link_background":"","ocean_menu_link_hover_background":"","ocean_menu_link_active_background":"","ocean_menu_social_links_bg":"","ocean_menu_social_hover_links_bg":"","ocean_menu_social_links_color":"","ocean_menu_social_hover_links_color":"","ocean_disable_title":"default","ocean_disable_heading":"default","ocean_post_title":"","ocean_post_subheading":"","ocean_post_title_style":"","ocean_post_title_background_color":"","ocean_post_title_background":0,"ocean_post_title_bg_image_position":"","ocean_post_title_bg_image_attachment":"","ocean_post_title_bg_image_repeat":"","ocean_post_title_bg_image_size":"","ocean_post_title_height":0,"ocean_post_title_bg_overlay":0.5,"ocean_post_title_bg_overlay_color":"","ocean_disable_breadcrumbs":"default","ocean_breadcrumbs_color":"","ocean_breadcrumbs_separator_color":"","ocean_breadcrumbs_links_color":"","ocean_breadcrumbs_links_hover_color":"","ocean_display_footer_widgets":"default","ocean_display_footer_bottom":"default","ocean_custom_footer_template":"0","footnotes":"","ocean_post_oembed":"","ocean_post_self_hosted_media":"","ocean_post_video_embed":"","ocean_link_format":"","ocean_link_format_target":"self","ocean_quote_format":"","ocean_quote_format_link":"post","ocean_gallery_link_images":"off","ocean_gallery_id":[]},"categories":[315],"tags":[],"coauthors":[292],"_links":{"self":[{"href":"https:\/\/audioworx.transfunnel.co\/old\/index.php?rest_route=\/wp\/v2\/posts\/25170"}],"collection":[{"href":"https:\/\/audioworx.transfunnel.co\/old\/index.php?rest_route=\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/audioworx.transfunnel.co\/old\/index.php?rest_route=\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/audioworx.transfunnel.co\/old\/index.php?rest_route=\/wp\/v2\/users\/107"}],"replies":[{"embeddable":true,"href":"https:\/\/audioworx.transfunnel.co\/old\/index.php?rest_route=%2Fwp%2Fv2%2Fcomments&post=25170"}],"version-history":[{"count":12,"href":"https:\/\/audioworx.transfunnel.co\/old\/index.php?rest_route=\/wp\/v2\/posts\/25170\/revisions"}],"predecessor-version":[{"id":27826,"href":"https:\/\/audioworx.transfunnel.co\/old\/index.php?rest_route=\/wp\/v2\/posts\/25170\/revisions\/27826"}],"wp:attachment":[{"href":"https:\/\/audioworx.transfunnel.co\/old\/index.php?rest_route=%2Fwp%2Fv2%2Fmedia&parent=25170"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/audioworx.transfunnel.co\/old\/index.php?rest_route=%2Fwp%2Fv2%2Fcategories&post=25170"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/audioworx.transfunnel.co\/old\/index.php?rest_route=%2Fwp%2Fv2%2Ftags&post=25170"},{"taxonomy":"author","embeddable":true,"href":"https:\/\/audioworx.transfunnel.co\/old\/index.php?rest_route=%2Fwp%2Fv2%2Fcoauthors&post=25170"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}