Add linear function to rank_feature query

Author: stevejgordon

src/Nest/QueryDsl/Specialized/RankFeature/RankFeatureQuery.cs

@@ -56,6 +56,13 @@ public RankFeatureQueryDescriptor<T> Logarithm(Func<RankFeatureLogarithmFunction
 		/// <inheritdoc cref="IRankFeatureSigmoidFunction"/>
 		public RankFeatureQueryDescriptor<T> Sigmoid(Func<RankFeatureSigmoidFunctionDescriptor, IRankFeatureSigmoidFunction> selector) =>
 			Assign(selector, (a, v) => a.Function = v?.Invoke(new RankFeatureSigmoidFunctionDescriptor()));
+
+		/// <inheritdoc cref="IRankFeatureLinearFunction"/>
+		public RankFeatureQueryDescriptor<T> Linear()
+		{
+			Self.Function = new RankFeatureLinearFunction();
+			return this;
+		}
 	}
 
 	/// <summary>
@@ -164,6 +171,24 @@ public class RankFeatureSigmoidFunctionDescriptor
 		public RankFeatureSigmoidFunctionDescriptor Pivot(float pivot) => Assign(pivot, (a, v) => a.Pivot = v);
 	}
 
+	/// <summary>
+	/// Gives a score equal to the indexed value of S, where S is the value of the rank feature field.
+	///
+	/// If a rank feature field is indexed with "positive_score_impact": true, its indexed value is equal to S and rounded to preserve
+	/// only 9 significant bits for the precision.
+	/// 
+	/// If a rank feature field is indexed with "positive_score_impact": false, its indexed value is equal to 1/S and rounded to
+	/// preserve only 9 significant bits for the precision.
+	/// </summary>
+	public interface IRankFeatureLinearFunction : IRankFeatureFunction
+	{
+	}
+
+	/// <inheritdoc cref="IRankFeatureLinearFunction" />
+	public class RankFeatureLinearFunction : IRankFeatureLinearFunction
+	{
+	}
+
 	internal class RankFeatureQueryFormatter : IJsonFormatter<IRankFeatureQuery>
 	{
 		public void Serialize(ref JsonWriter writer, IRankFeatureQuery value, IJsonFormatterResolver formatterResolver)
@@ -208,6 +233,9 @@ public void Serialize(ref JsonWriter writer, IRankFeatureQuery value, IJsonForma
 					case IRankFeatureLogarithmFunction log:
 						SerializeScoreFunction(ref writer, "log", log, formatterResolver);
 						break;
+					case IRankFeatureLinearFunction log:
+						SerializeScoreFunction(ref writer, "linear", log, formatterResolver);
+						break;
 				}
 			}
 
@@ -234,7 +262,8 @@ private static IRankFeatureFunction DeserializeScoreFunction<TScoreFunction>(ref
 			{ "field", 2 },
 			{ "saturation", 3 },
 			{ "log", 4 },
-			{ "sigmoid", 5 }
+			{ "sigmoid", 5 },
+			{ "linear", 6 }
 		};
 
 		public IRankFeatureQuery Deserialize(ref JsonReader reader, IJsonFormatterResolver formatterResolver)
@@ -268,6 +297,9 @@ public IRankFeatureQuery Deserialize(ref JsonReader reader, IJsonFormatterResolv
 						case 5:
 							query.Function = DeserializeScoreFunction<RankFeatureSigmoidFunction>(ref reader, formatterResolver);
 							break;
+						case 6:
+							query.Function = DeserializeScoreFunction<RankFeatureLinearFunction>(ref reader, formatterResolver);
+							break;
 					}
 				}
 				else

tests/Tests/QueryDsl/Specialized/RankFeature/RankFeatureQueryUsageTests.cs

@@ -71,4 +71,26 @@ protected override QueryContainer QueryFluent(QueryContainerDescriptor<Project>
 				.Field(f => f.Rank)
 			);
 	}
+
+	public class RankFeatureLinearFunctionUsageTests : QueryDslUsageTestsBase
+	{
+		public RankFeatureLinearFunctionUsageTests(ReadOnlyCluster i, EndpointUsage usage) : base(i, usage) { }
+		protected override QueryContainer QueryInitializer => new RankFeatureQuery
+		{
+			Name = "named_query",
+			Boost = 1.1,
+			Field = Infer.Field<Project>(f => f.Rank),
+			Function = new RankFeatureLinearFunction()
+		};
+
+		protected override object QueryJson =>
+			new { rank_feature = new { _name = "named_query", boost = 1.1, field = "rank", linear = new { } } };
+
+		protected override QueryContainer QueryFluent(QueryContainerDescriptor<Project> q) => q
+			.RankFeature(rf => rf
+				.Name("named_query")
+				.Boost(1.1)
+				.Field(f => f.Rank)
+				.Linear());
+	}
 }