\n| \n Name<\/strong><\/p>\n<\/td>\n| \n Description<\/strong><\/p>\n<\/td>\n| \n Usage<\/strong><\/p>\n<\/td>\n| \n Result<\/strong><\/p>\n<\/td>\n<\/tr>\n\n| \n Abs<\/p>\n<\/td>\n | \n Returns the absolute value of a specified number.<\/p>\n<\/td>\n | \n Abs(-1)<\/p>\n<\/td>\n | \n 1M<\/p>\n<\/td>\n<\/tr>\n | \n| \n Acos<\/p>\n<\/td>\n | \n Returns the angle whose cosine is the specified number.<\/p>\n<\/td>\n | \n Acos(1)<\/p>\n<\/td>\n | \n 0d<\/p>\n<\/td>\n<\/tr>\n | \n| \n Asin<\/p>\n<\/td>\n | \n Returns the angle whose sine is the specified number.<\/p>\n<\/td>\n | \n Asin(0)<\/p>\n<\/td>\n | \n 0d<\/p>\n<\/td>\n<\/tr>\n | \n| \n Atan<\/p>\n<\/td>\n | \n Returns the angle whose tangent is the specified number.<\/p>\n<\/td>\n | \n Atan(0)<\/p>\n<\/td>\n | \n 0d<\/p>\n<\/td>\n<\/tr>\n | \n| \n Ceiling<\/p>\n<\/td>\n | \n Returns the smallest integer greater than or equal to the specified number.<\/p>\n<\/td>\n | \n Ceiling(1.5)<\/p>\n<\/td>\n | \n 2d<\/p>\n<\/td>\n<\/tr>\n | \n| \n Cos<\/p>\n<\/td>\n | \n Returns the cosine of the specified angle.<\/p>\n<\/td>\n | \n Cos(0)<\/p>\n<\/td>\n | \n 1d<\/p>\n<\/td>\n<\/tr>\n | \n| \n Exp<\/p>\n<\/td>\n | \n Returns e raised to the specified power.<\/p>\n<\/td>\n | \n Exp(0)<\/p>\n<\/td>\n | \n 1d<\/p>\n<\/td>\n<\/tr>\n | \n| \n Floor<\/p>\n<\/td>\n | \n Returns the largest integer less than or equal to the specified number.<\/p>\n<\/td>\n | \n Floor(1.5)<\/p>\n<\/td>\n | \n 1d<\/p>\n<\/td>\n<\/tr>\n | \n| \n IEEERemainder<\/p>\n<\/td>\n | \n Returns the remainder resulting from the division of a specified number by another specified number.<\/p>\n<\/td>\n | \n IEEERemainder(3, 2)<\/p>\n<\/td>\n | \n -1d<\/p>\n<\/td>\n<\/tr>\n | \n| \n Log<\/p>\n<\/td>\n | \n Returns the logarithm of a specified number.<\/p>\n<\/td>\n | \n Log(1, 10)<\/p>\n<\/td>\n | \n 0d<\/p>\n<\/td>\n<\/tr>\n | \n| \n Log10<\/p>\n<\/td>\n | \n Returns the base 10 logarithm of a specified number.<\/p>\n<\/td>\n | \n Log10(1)<\/p>\n<\/td>\n | \n 0d<\/p>\n<\/td>\n<\/tr>\n | \n| \n Max<\/p>\n<\/td>\n | \n Returns the larger of two specified numbers.<\/p>\n<\/td>\n | \n Max(1, 2)<\/p>\n<\/td>\n | \n 2<\/p>\n<\/td>\n<\/tr>\n | \n| \n Min<\/p>\n<\/td>\n | \n Returns the smaller of two numbers.<\/p>\n<\/td>\n | \n Min(1, 2)<\/p>\n<\/td>\n | \n 1<\/p>\n<\/td>\n<\/tr>\n | \n| \n Pow<\/p>\n<\/td>\n | \n Returns a specified number raised to the specified power.<\/p>\n<\/td>\n | \n Pow(3, 2)<\/p>\n<\/td>\n | \n 9d<\/p>\n<\/td>\n<\/tr>\n | \n| \n Round<\/p>\n<\/td>\n | \n Rounds a value to the nearest integer or specified number of decimal places. The mid number behaviour can be changed by using EvaluateOption.RoundAwayFromZero during construction of the Expression object.<\/p>\n<\/td>\n | \n Round(3.222, 2)<\/p>\n<\/td>\n | \n 3.22d<\/p>\n<\/td>\n<\/tr>\n | \n| \n Sign<\/p>\n<\/td>\n | \n Returns a value indicating the sign of a number.<\/p>\n<\/td>\n | \n Sign(-10)<\/p>\n<\/td>\n | \n -1<\/p>\n<\/td>\n<\/tr>\n | \n| \n Sin<\/p>\n<\/td>\n | \n Returns the sine of the specified angle.<\/p>\n<\/td>\n | \n Sin(0)<\/p>\n<\/td>\n | \n 0d<\/p>\n<\/td>\n<\/tr>\n | \n| \n Sqrt<\/p>\n<\/td>\n | \n Returns the square root of a specified number.<\/p>\n<\/td>\n | \n Sqrt(4)<\/p>\n<\/td>\n | \n 2d<\/p>\n<\/td>\n<\/tr>\n | \n| \n Tan<\/p>\n<\/td>\n | \n Returns the tangent of the specified angle.<\/p>\n<\/td>\n | \n Tan(0)<\/p>\n<\/td>\n | \n 0d<\/p>\n<\/td>\n<\/tr>\n | \n| \n Truncate<\/p>\n<\/td>\n | \n Calculates the integral part of a number.<\/p>\n<\/td>\n | \n Truncate(1.7)<\/p>\n<\/td>\n | \n 1<\/p>\n<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n The following general purpose functions are also available:<\/p>\n \n\n\n| \n Name<\/strong><\/p>\n<\/td>\n| \n Description<\/strong><\/p>\n<\/td>\n| \n Usage<\/strong><\/p>\n<\/td>\n| \n Result<\/strong><\/p>\n<\/td>\n<\/tr>\n\n| \n in<\/p>\n<\/td>\n | \n Returns whether an element is in a set of values.<\/p>\n<\/td>\n | \n in(1 + 1, 1, 2, 3)<\/p>\n<\/td>\n | \n true<\/p>\n<\/td>\n<\/tr>\n | \n| \n if<\/p>\n<\/td>\n | \n Returns a value based on a condition.<\/p>\n<\/td>\n | \n if(3 % 2 = 1, 'value is true', 'value is false')<\/p>\n<\/td>\n | \n 'value is true'<\/p>\n<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n Parameters<\/h3>\nA parameter as a name and can be optionally contained inside brackets.<\/p>\n Example:<\/p>\n 2 + x, 2 + [x]<\/span><\/p>\nStatic parameters<\/h4>\nStatic parameters are values which can be defined before the evaluation of an expression. These parameters can be accessed using the Parameters<\/strong> dictionary of the Expression <\/strong>instance.<\/p>\n\n\n\nExpression e = new Expression(\"2 * [x] ^ 2 + 5 * [y]\");<\/span>
\ne.Parameters[\"x\"] = 5;<\/span>
\ne.Parameters[\"y\"] = 1;<\/span>
\nConsole.WriteLine(e.Evaluate());<\/span><\/td>\n<\/tr>\n<\/tbody>\n<\/table>\nParameters can be useful when a value is unknown at compile time, or when performance is important and the parsing can be saved for further calculations.<\/p>\n Expression parameters<\/h4>\nExpressions can be split into several ones by defining expression parameters. Those parameters are not simple values but Expression<\/strong> instances themselves.<\/p>\n\n\n\nExpression volume = new Expression(\"[surface] * h\");<\/span>
\nExpression surface = new Expression(\"[l] * [L]\");<\/span>
\nvolume.Parameters[\"surface\"] = surface;<\/span>
\nsurface.Parameters[\"l\"] = 1;<\/span>
\nsurface.Parameters[\"L\"] = 2;<\/span><\/td>\n<\/tr>\n<\/tbody>\n<\/table>\nDynamic parameters<\/h4>\nSometimes parameters can be even more complex to evaluate and need a dedicated method to be evaluated. This can be done by intercepting there evaluation using the EvaluateParameter<\/strong> event published on Expression<\/strong> instances. Thus, each time a parameter is not defined in the dictionary, this event is called to try to resolve the value.<\/p>\n\n\n\nExpression e = new Expression(\"Round(Pow([Pi], 2) + Pow([Pi], 2) + [X], 2)\");<\/span>
\ne.Parameters[\"Pi2\"] = new Expression(\"Pi * [Pi]\");<\/span>
\ne.Parameters[\"X\"] = 10;<\/span>
\ne.EvaluateParameter += delegate(string name, ParameterArgs args)
\n{<\/span>
\nif (name == \"Pi\")<\/span>
\nargs.Result = 3.14;<\/span>
\n};<\/span><\/td>\n<\/tr>\n<\/tbody>\n<\/table>\nSquare brackets parameters<\/span><\/p>\nParameters in between square brackets can contain special characters like spaces, dots, and also start with digits.<\/p>\n \n\n\nExpression e = new Expression(\"[My First Parameter] + [My Second Parameter]\");<\/span><\/td>\n<\/tr>\n<\/tbody>\n<\/table>\nMulti-valued parameters<\/h4>\nWhen parameters are IEnumerable and the EvaluationOptions.IterateParameters<\/strong> is used, the result is an IList<\/strong> made of the evaluation of each value in the parameter.<\/p>\n\n\n\nExpression e = new Expression(\"(a * b) ^ c\", EvaluateOption.IterateParameters);<\/span>
\ne.Parameters[\"a\"] = new int[] { 1, 2, 3, 4, 5 };<\/span>
\ne.Parameters[\"b\"] = new int[] { 6, 7, 8, 9, 0 };<\/span>
\ne.Parameters[\"c\"] = 3;<\/span>
\nforeach (var result in (IList)e.Evaluate())<\/span>
\n{<\/span>
\nConsole.WriteLine(result);<\/span>
\n}<\/span>
\n\/\/ 216<\/span>
\n\/\/ 2744<\/span>
\n\/\/ 13824<\/span>
\n\/\/ 46656<\/span>
\n\/\/ 0<\/span><\/td>\n<\/tr>\n<\/tbody>\n<\/table>\nUnary<\/h2>\n\n\n\n| !, not, -, ~ (bitwise not)<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n Example:<\/p>\n not true<\/span><\/p>\nBitwise<\/h2>\n\n\n\n| & (bitwise and), | (bitwise or), ^(bitwise xor), << (left shift), >>(right shift)<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n Example:<\/p>\n 2 >> 3<\/span><\/p>\nMultiplicative<\/h2>\n\n\n\n| *, \/, %<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n Example:<\/p>\n 1 * 2 % 3<\/span><\/p>\nAdditive<\/h2>\n\n\n\n| +, -<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n Example:<\/p>\n 1 + 2 - 3<\/span><\/p>\nRelational<\/h2>\n\n\n\n| \n =, ==, !=, <><\/p>\n <, <=, >, >=<\/p>\n<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n Example:<\/p>\n 1 < 2<\/span><\/p>\nLogical<\/h2>\nThese operators can perform a logical comparison between other expressions.<\/p>\n \n\n\n| \n or, ||<\/p>\n and, &&<\/p>\n<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n The and <\/strong>operator has higher priority than the or<\/strong>, thus in the following example, false and true <\/strong>is evaluated first.<\/p>\nExample:<\/p>\n true or false and true<\/span><\/p>\nGlossary<\/h1>\nArea Equipment<\/p>\n Equipment, typically belonging to a plant or facility, that may affect loss at upstream measurement points.<\/p>\n Availability Event<\/p>\n A quantifiable time frame when a measurement point is not working or not working to an appropriate proportion of design capacity. Availability events can be a pre-cursor to loss events. Availability of a measurement point is an opportunity.<\/p>\n Cause<\/p>\n A predefined list of states or activities relating to a piece of equipment attributed to production event.<\/p>\n Downtime<\/p>\n A state where production has stopped over a period of time.<\/p>\n Equipment Hierarchy<\/p>\n A collection of equipment (grouped in a hierarchy) which summarises the equipment of interest for loss and downtime reporting.<\/p>\n Loss<\/p>\n A state where production is below a specified threshold but has not stopped over a period of time.<\/p>\n Loss Event<\/p>\n Loss is the incomplete utilisation of a piece of equipment, or a lost opportunity for production. While it may be possible to assign an actual cost of amount, the base Unit for loss is time.<\/p>\n Measurement Point Group<\/p>\n A mechanism for grouping measurement points into convenient geographical groups for reporting purposes.<\/p>\n Production Stream<\/p>\n A Production Stream provides a convenient way of grouping equipment for reporting purposes. A piece of equipment can belong to only one Production Stream.<\/p>\n Reason<\/p>\n A predefined list of states or activities relating to a piece of equipment attributed to production event.<\/p>\n Workflow<\/p>\n A set of activities that describe real world processes.<\/p>\n \u00a0<\/p>\n","protected":false},"excerpt":{"rendered":" Syntax for calculated quantities and how to use operators to combine expressions.<\/p>\n Read more<\/i><\/a><\/p>\n","protected":false},"author":29,"featured_media":0,"parent":280,"menu_order":78,"comment_status":"closed","ping_status":"closed","template":"","meta":{"footnotes":"","_members_access_role":[],"_members_access_error":""},"categories":[4],"tags":[],"class_list":["post-62269","page","type-page","status-publish","hentry","category-explainer","Version-4-14","Product-ap"],"_links":{"self":[{"href":"https:\/\/oihelp.corporate.ifs.com\/help\/wp-json\/wp\/v2\/pages\/62269","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/oihelp.corporate.ifs.com\/help\/wp-json\/wp\/v2\/pages"}],"about":[{"href":"https:\/\/oihelp.corporate.ifs.com\/help\/wp-json\/wp\/v2\/types\/page"}],"author":[{"embeddable":true,"href":"https:\/\/oihelp.corporate.ifs.com\/help\/wp-json\/wp\/v2\/users\/29"}],"replies":[{"embeddable":true,"href":"https:\/\/oihelp.corporate.ifs.com\/help\/wp-json\/wp\/v2\/comments?post=62269"}],"version-history":[{"count":32,"href":"https:\/\/oihelp.corporate.ifs.com\/help\/wp-json\/wp\/v2\/pages\/62269\/revisions"}],"predecessor-version":[{"id":63745,"href":"https:\/\/oihelp.corporate.ifs.com\/help\/wp-json\/wp\/v2\/pages\/62269\/revisions\/63745"}],"up":[{"embeddable":true,"href":"https:\/\/oihelp.corporate.ifs.com\/help\/wp-json\/wp\/v2\/pages\/280"}],"wp:attachment":[{"href":"https:\/\/oihelp.corporate.ifs.com\/help\/wp-json\/wp\/v2\/media?parent=62269"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/oihelp.corporate.ifs.com\/help\/wp-json\/wp\/v2\/categories?post=62269"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/oihelp.corporate.ifs.com\/help\/wp-json\/wp\/v2\/tags?post=62269"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}} | | | | | | | | | | | | | | | | | | | | |