SmoothedHingeLoss.xml

<Type Name="SmoothedHingeLoss" FullName="Microsoft.ML.Trainers.SmoothedHingeLoss">
  <TypeSignature Language="C#" Value="public sealed class SmoothedHingeLoss : Microsoft.ML.Trainers.ILossFunction&lt;float,float&gt;, Microsoft.ML.Trainers.ISupportSdcaClassificationLoss" />
  <TypeSignature Language="ILAsm" Value=".class public auto ansi sealed beforefieldinit SmoothedHingeLoss extends System.Object implements class Microsoft.ML.Trainers.IClassificationLoss, class Microsoft.ML.Trainers.ILossFunction`2&lt;float32, float32&gt;, class Microsoft.ML.Trainers.IScalarLoss, class Microsoft.ML.Trainers.ISupportSdcaClassificationLoss, class Microsoft.ML.Trainers.ISupportSdcaLoss" />
  <TypeSignature Language="DocId" Value="T:Microsoft.ML.Trainers.SmoothedHingeLoss" />
  <TypeSignature Language="VB.NET" Value="Public NotInheritable Class SmoothedHingeLoss&#xA;Implements ILossFunction(Of Single, Single), ISupportSdcaClassificationLoss" />
  <TypeSignature Language="F#" Value="type SmoothedHingeLoss = class&#xA;    interface ISupportSdcaClassificationLoss&#xA;    interface ISupportSdcaLoss&#xA;    interface IScalarLoss&#xA;    interface ILossFunction&lt;single, single&gt;&#xA;    interface IClassificationLoss" />
  <AssemblyInfo>
    <AssemblyName>Microsoft.ML.Data</AssemblyName>
    <AssemblyVersion>1.0.0.0</AssemblyVersion>
  </AssemblyInfo>
  <Base>
    <BaseTypeName>System.Object</BaseTypeName>
  </Base>
  <Interfaces>
    <Interface>
      <InterfaceName>Microsoft.ML.Trainers.IClassificationLoss</InterfaceName>
    </Interface>
    <Interface>
      <InterfaceName>Microsoft.ML.Trainers.ILossFunction&lt;System.Single,System.Single&gt;</InterfaceName>
    </Interface>
    <Interface>
      <InterfaceName>Microsoft.ML.Trainers.IScalarLoss</InterfaceName>
    </Interface>
    <Interface>
      <InterfaceName>Microsoft.ML.Trainers.ISupportSdcaClassificationLoss</InterfaceName>
    </Interface>
    <Interface>
      <InterfaceName>Microsoft.ML.Trainers.ISupportSdcaLoss</InterfaceName>
    </Interface>
  </Interfaces>
  <Docs>
    <summary>
             A smooth version of the <see cref="T:Microsoft.ML.Trainers.HingeLoss" /> function, commonly used in classification tasks.
             </summary>
    <remarks>
      <format type="text/markdown"><![CDATA[
            
             Let $f(\hat{y}, y) = 1 - y\hat{y}$, where $\hat{y}$ is the predicted score and $y \in \\{-1, 1\\}$ is the true label. $f(\hat{y}, y)$ here is the non-zero portion of the [Hinge Loss](xref:Microsoft.ML.Trainers.HingeLoss).
            
             Note that the labels used in this calculation are -1 and 1, unlike [Log Loss](xref:Microsoft.ML.Trainers.LogLoss), where the labels used are 0 and 1.
             Also unlike [Log Loss](xref:Microsoft.ML.Trainers.LogLoss), $\hat{y}$ is the raw predicted score, not the predicted probability (which is calculated by applying a [sigmoid function](https://en.wikipedia.org/wiki/Sigmoid_function) to the predicted score).
            
             The Smoothed Hinge Loss function is then defined as:
            
             $
             L(f(\hat{y}, y)) =
             \begin{cases}
             0                                  & \text{if } f(\hat{y}, y) < 0 \\\\
             \frac{(f(\hat{y}, y))^2}{2\alpha}  & \text{if } f(\hat{y}, y) < \alpha \\\\
             f(\hat{y}, y) - \frac{\alpha}{2}   & \text{otherwise}
             \end{cases}
             $
            
             where $\alpha$ is a smoothing parameter set to 1 by default.
            
             ]]></format>
    </remarks>
  </Docs>
  <Members>
    <Member MemberName=".ctor">
      <MemberSignature Language="C#" Value="public SmoothedHingeLoss (float smoothingConstant = 1);" />
      <MemberSignature Language="ILAsm" Value=".method public hidebysig specialname rtspecialname instance void .ctor(float32 smoothingConstant) cil managed" />
      <MemberSignature Language="DocId" Value="M:Microsoft.ML.Trainers.SmoothedHingeLoss.#ctor(System.Single)" />
      <MemberSignature Language="VB.NET" Value="Public Sub New (Optional smoothingConstant As Single = 1)" />
      <MemberSignature Language="F#" Value="new Microsoft.ML.Trainers.SmoothedHingeLoss : single -&gt; Microsoft.ML.Trainers.SmoothedHingeLoss" Usage="new Microsoft.ML.Trainers.SmoothedHingeLoss smoothingConstant" />
      <MemberType>Constructor</MemberType>
      <AssemblyInfo>
        <AssemblyName>Microsoft.ML.Data</AssemblyName>
        <AssemblyVersion>1.0.0.0</AssemblyVersion>
      </AssemblyInfo>
      <Parameters>
        <Parameter Name="smoothingConstant" Type="System.Single" />
      </Parameters>
      <Docs>
        <param name="smoothingConstant">The smoothing constant.</param>
        <summary>
            Constructor for smoothed hinge losee.
            </summary>
        <remarks>To be added.</remarks>
      </Docs>
    </Member>
    <Member MemberName="ComputeDualUpdateInvariant">
      <MemberSignature Language="C#" Value="public float ComputeDualUpdateInvariant (float scaledFeaturesNormSquared);" />
      <MemberSignature Language="ILAsm" Value=".method public hidebysig newslot virtual instance float32 ComputeDualUpdateInvariant(float32 scaledFeaturesNormSquared) cil managed" />
      <MemberSignature Language="DocId" Value="M:Microsoft.ML.Trainers.SmoothedHingeLoss.ComputeDualUpdateInvariant(System.Single)" />
      <MemberSignature Language="VB.NET" Value="Public Function ComputeDualUpdateInvariant (scaledFeaturesNormSquared As Single) As Single" />
      <MemberSignature Language="F#" Value="abstract member ComputeDualUpdateInvariant : single -&gt; single&#xA;override this.ComputeDualUpdateInvariant : single -&gt; single" Usage="smoothedHingeLoss.ComputeDualUpdateInvariant scaledFeaturesNormSquared" />
      <MemberType>Method</MemberType>
      <Implements>
        <InterfaceMember>M:Microsoft.ML.Trainers.ISupportSdcaLoss.ComputeDualUpdateInvariant(System.Single)</InterfaceMember>
      </Implements>
      <AssemblyInfo>
        <AssemblyName>Microsoft.ML.Data</AssemblyName>
        <AssemblyVersion>1.0.0.0</AssemblyVersion>
      </AssemblyInfo>
      <ReturnValue>
        <ReturnType>System.Single</ReturnType>
      </ReturnValue>
      <Parameters>
        <Parameter Name="scaledFeaturesNormSquared" Type="System.Single" />
      </Parameters>
      <Docs>
        <param name="scaledFeaturesNormSquared">To be added.</param>
        <summary>To be added.</summary>
        <returns>To be added.</returns>
        <remarks>To be added.</remarks>
      </Docs>
    </Member>
    <Member MemberName="Derivative">
      <MemberSignature Language="C#" Value="public float Derivative (float output, float label);" />
      <MemberSignature Language="ILAsm" Value=".method public hidebysig newslot virtual instance float32 Derivative(float32 output, float32 label) cil managed" />
      <MemberSignature Language="DocId" Value="M:Microsoft.ML.Trainers.SmoothedHingeLoss.Derivative(System.Single,System.Single)" />
      <MemberSignature Language="VB.NET" Value="Public Function Derivative (output As Single, label As Single) As Single" />
      <MemberSignature Language="F#" Value="abstract member Derivative : single * single -&gt; single&#xA;override this.Derivative : single * single -&gt; single" Usage="smoothedHingeLoss.Derivative (output, label)" />
      <MemberType>Method</MemberType>
      <Implements>
        <InterfaceMember>M:Microsoft.ML.Trainers.IScalarLoss.Derivative(System.Single,System.Single)</InterfaceMember>
      </Implements>
      <AssemblyInfo>
        <AssemblyName>Microsoft.ML.Data</AssemblyName>
        <AssemblyVersion>1.0.0.0</AssemblyVersion>
      </AssemblyInfo>
      <ReturnValue>
        <ReturnType>System.Single</ReturnType>
      </ReturnValue>
      <Parameters>
        <Parameter Name="output" Type="System.Single" />
        <Parameter Name="label" Type="System.Single" />
      </Parameters>
      <Docs>
        <param name="output">To be added.</param>
        <param name="label">To be added.</param>
        <summary>To be added.</summary>
        <returns>To be added.</returns>
        <remarks>To be added.</remarks>
      </Docs>
    </Member>
    <Member MemberName="DualLoss">
      <MemberSignature Language="C#" Value="public double DualLoss (float label, float dual);" />
      <MemberSignature Language="ILAsm" Value=".method public hidebysig newslot virtual instance float64 DualLoss(float32 label, float32 dual) cil managed" />
      <MemberSignature Language="DocId" Value="M:Microsoft.ML.Trainers.SmoothedHingeLoss.DualLoss(System.Single,System.Single)" />
      <MemberSignature Language="VB.NET" Value="Public Function DualLoss (label As Single, dual As Single) As Double" />
      <MemberSignature Language="F#" Value="abstract member DualLoss : single * single -&gt; double&#xA;override this.DualLoss : single * single -&gt; double" Usage="smoothedHingeLoss.DualLoss (label, dual)" />
      <MemberType>Method</MemberType>
      <Implements>
        <InterfaceMember>M:Microsoft.ML.Trainers.ISupportSdcaLoss.DualLoss(System.Single,System.Single)</InterfaceMember>
      </Implements>
      <AssemblyInfo>
        <AssemblyName>Microsoft.ML.Data</AssemblyName>
        <AssemblyVersion>1.0.0.0</AssemblyVersion>
      </AssemblyInfo>
      <ReturnValue>
        <ReturnType>System.Double</ReturnType>
      </ReturnValue>
      <Parameters>
        <Parameter Name="label" Type="System.Single" />
        <Parameter Name="dual" Type="System.Single" />
      </Parameters>
      <Docs>
        <param name="label">To be added.</param>
        <param name="dual">To be added.</param>
        <summary>To be added.</summary>
        <returns>To be added.</returns>
        <remarks>To be added.</remarks>
      </Docs>
    </Member>
    <Member MemberName="DualUpdate">
      <MemberSignature Language="C#" Value="public float DualUpdate (float output, float label, float alpha, float invariant, int maxNumThreads);" />
      <MemberSignature Language="ILAsm" Value=".method public hidebysig newslot virtual instance float32 DualUpdate(float32 output, float32 label, float32 alpha, float32 invariant, int32 maxNumThreads) cil managed" />
      <MemberSignature Language="DocId" Value="M:Microsoft.ML.Trainers.SmoothedHingeLoss.DualUpdate(System.Single,System.Single,System.Single,System.Single,System.Int32)" />
      <MemberSignature Language="VB.NET" Value="Public Function DualUpdate (output As Single, label As Single, alpha As Single, invariant As Single, maxNumThreads As Integer) As Single" />
      <MemberSignature Language="F#" Value="abstract member DualUpdate : single * single * single * single * int -&gt; single&#xA;override this.DualUpdate : single * single * single * single * int -&gt; single" Usage="smoothedHingeLoss.DualUpdate (output, label, alpha, invariant, maxNumThreads)" />
      <MemberType>Method</MemberType>
      <Implements>
        <InterfaceMember>M:Microsoft.ML.Trainers.ISupportSdcaLoss.DualUpdate(System.Single,System.Single,System.Single,System.Single,System.Int32)</InterfaceMember>
      </Implements>
      <AssemblyInfo>
        <AssemblyName>Microsoft.ML.Data</AssemblyName>
        <AssemblyVersion>1.0.0.0</AssemblyVersion>
      </AssemblyInfo>
      <ReturnValue>
        <ReturnType>System.Single</ReturnType>
      </ReturnValue>
      <Parameters>
        <Parameter Name="output" Type="System.Single" />
        <Parameter Name="label" Type="System.Single" />
        <Parameter Name="alpha" Type="System.Single" />
        <Parameter Name="invariant" Type="System.Single" />
        <Parameter Name="maxNumThreads" Type="System.Int32" />
      </Parameters>
      <Docs>
        <param name="output">To be added.</param>
        <param name="label">To be added.</param>
        <param name="alpha">To be added.</param>
        <param name="invariant">To be added.</param>
        <param name="maxNumThreads">To be added.</param>
        <summary>To be added.</summary>
        <returns>To be added.</returns>
        <remarks>To be added.</remarks>
      </Docs>
    </Member>
    <Member MemberName="Loss">
      <MemberSignature Language="C#" Value="public double Loss (float output, float label);" />
      <MemberSignature Language="ILAsm" Value=".method public hidebysig newslot virtual instance float64 Loss(float32 output, float32 label) cil managed" />
      <MemberSignature Language="DocId" Value="M:Microsoft.ML.Trainers.SmoothedHingeLoss.Loss(System.Single,System.Single)" />
      <MemberSignature Language="VB.NET" Value="Public Function Loss (output As Single, label As Single) As Double" />
      <MemberSignature Language="F#" Value="abstract member Loss : single * single -&gt; double&#xA;override this.Loss : single * single -&gt; double" Usage="smoothedHingeLoss.Loss (output, label)" />
      <MemberType>Method</MemberType>
      <Implements>
        <InterfaceMember>M:Microsoft.ML.Trainers.ILossFunction`2.Loss(`0,`1)</InterfaceMember>
      </Implements>
      <AssemblyInfo>
        <AssemblyName>Microsoft.ML.Data</AssemblyName>
        <AssemblyVersion>1.0.0.0</AssemblyVersion>
      </AssemblyInfo>
      <ReturnValue>
        <ReturnType>System.Double</ReturnType>
      </ReturnValue>
      <Parameters>
        <Parameter Name="output" Type="System.Single" />
        <Parameter Name="label" Type="System.Single" />
      </Parameters>
      <Docs>
        <param name="output">To be added.</param>
        <param name="label">To be added.</param>
        <summary>To be added.</summary>
        <returns>To be added.</returns>
        <remarks>To be added.</remarks>
      </Docs>
    </Member>
  </Members>
</Type>