@frontlinesystems/rason-mcp-server 2026.5.0 → 2026.5.1

package/examples/{Optimization → optimization}/Conic/AirlineHubConic.json

@@ -1,112 +1,112 @@
-{
-  "modelName": "AirlineHubConicExample",
-  "modelDescription": "Conic Constraint Optimization Example RASON Model: This model minimizes the distance between several regional airports and a proposed hub location. In the original AirlineHub models, found within the Nonlinear examples, the Pythagorean Theorem was used to calculate the distance of each city to the proposed airport hub location.  Since this distance calculation was nonlinear, a nonlinear engine was required to solve the model, such as the Standard GRG Engine.  In this example, however, we will use 6 conic constraints (one for each regional airline location) to calculate the distance between the airline hub and the regional airports. Removing the nonlinear functions and replacing them with conic constraints results in a SOCP Convex model which can be solved faster and more reliably with the SOCP engine.",
-  "modelType": "optimization",
-  "engineSettings": {
-    "comment": "Since this model uses conic constraints, the SOCP Barrier engine must be selected.  A simple example of a conic constraint is a non-negativity constraint on the decision variables.  A non-negativity constraint simply means that all variables must be greater than 0.  In this model, the variable blocks F21:F26, G21:G26 and H21:H26 must lie within a 2nd order cone (also called a Lorentz cone or 'ice cream cone'). This cone places a bound on the L2-norm of the vector of decision variables.  In this model, if the variables in cells F21:F26, G21:G26 and H21:H26 lie within a code, then FX >= SQRT(SUMSQ(GX:HX))",
-    "engine": "SOCP Barrier"
-  },
-  "variables": {
-    "comment": "There are 21 total variables in the model.",
-    "x": {
-      "comment": "The x variable represents the x coordinate of the proposed hub location.",
-      "value": 1.0,
-      "finalValue": []
-    },
-    "y": {
-      "comment": "The y variable represents the y coordinate of the proposed hub location.",
-      "value": 1.0,
-      "finalValue": []
-    },
-    "z": {
-      "comment": "The z variable is an artificial variable that will be used to 'squash' or incentivize RASON Decision Services to find a location for the hub that minimizes the distances between the hub and each regional airport.",
-      "value": 1.0,
-      "finalValue": []
-    },
-    "f21:f26": {
-      "comment": "These variables are new to the conic formulation.  These are required to setup the conic constraints, see below. Each set of three variables, for example F21:H21, must belong to a second order cone constraint (F21:H21 = conic) which can be rewritten as F21 >= SQRT(SUMSQ(G21:H21). The 6 conic constraints replace the nonlinear distance calculation in the C1, C2, C3, C4, C5 and C6 constraints in the AirlineHub model.",
-      "value": 1.0
-    },
-    "g21:g26": {
-      "comment": "These variables are new to the conic formulation.  These are required to setup the conic constraints, see below.",
-      "value": 1.0
-    },
-    "h21:h26": {
-      "comment": "These variables are new to the conic formulation.  These are required to setup the conic constraints, see below.",
-      "value": 1.0
-    }
-  },
-  "data": {
-    "comment": "The data section (optional) can be used to setup constant arrays or generate formulas to be utilized in the constraints and objective. ",
-    "corx": {
-      "comment": "This array contains the x coordinates for each regional airport.",
-      "dimensions": [ 6 ],
-      "value": [ 1, 0.5, 2, 2, 2, 0.5 ]
-    },
-    "cory": {
-      "comment": "This array contains the y coordinates for each regional airport.",
-      "dimensions": [ 6 ],
-      "value": [ 4, 3, 4, 2, 5, 6 ]
-    }
-  },
-  "constraints": {
-    "dx": {
-      "comment": "The differences between the x coordinates of the hub and each regional airport. This constraint is set equal to the new variables, G21:G26.",
-      "dimensions": [ 6 ],
-      "formula": "corx - x - g21:g26",
-      "lower": 0,
-      "upper": 0
-    },
-    "dy": {
-      "comment": "The differences between the y coordinates of the hub and each regional airport. This constraint is set equal to the new variables, H21:H26.",
-      "dimensions": [ 6 ],
-      "formula": "cory - y - h21:h26",
-      "lower": 0,
-      "upper": 0
-    },
-    "dz": {
-      "comment": "The effect of this constraint, coupled with the minimization of the z artificial variable, results in the artificial variable becoming equal to the maximum value in the f21:f26 variable array, in the final solution",
-      "dimensions": [ 6 ],
-      "formula": "f21:f26 - z",
-      "upper": 0
-    },
-    "cone1": {
-      "comment": "This comment applies to all 6 cone constraints, below.  Each set of 3 variables for example, F21, G21 and H21, must belong to a second order cone constraint which can be rewritten as F21 >= SQRT(SumSQ(G21:H21). These 6 conic constraints replace the nonlinear distance constraints in the original AirlineHub example.",
-      "value": "f21:h21",
-      "type": "cone"
-    },
-    "cone2": {
-      "comment": "cone constraint for f22, g22 and h22",
-      "value": "f22:h22",
-      "type": "cone"
-    },
-    "cone3": {
-      "comment": "cone constraint for f23, g23 and h23",
-      "value": "f23:h23",
-      "type": "cone"
-    },
-    "cone4": {
-      "comment": "cone constraint for f24, g24 and h24",
-      "value": "f24:h24",
-      "type": "cone"
-    },
-    "cone5": {
-      "comment": "cone constraint for f25, g25 and h25",
-      "value": "f25:h25",
-      "type": "cone"
-    },
-    "cone6": {
-      "comment": "cone constraint for f26, g26 and h26",
-      "value": "f26:h26",
-      "type": "cone"
-    }
-  },
-  "objective": {
-    "obj": {
-      "comment": "The objective, the z variable, is a decision variable being minimized. The effect of this variable being minimized, coupled with the dz constraint, results in the dz variable being equal to the max of F21:F26 variable values in the final solution.",
-      "formula": "z",
-      "type": "minimize",
-      "finalValue": []
-    }
-  }
+{
+  "modelName": "AirlineHubConicExample",
+  "modelDescription": "Conic Constraint Optimization Example RASON Model: This model minimizes the distance between several regional airports and a proposed hub location. In the original AirlineHub models, found within the Nonlinear examples, the Pythagorean Theorem was used to calculate the distance of each city to the proposed airport hub location.  Since this distance calculation was nonlinear, a nonlinear engine was required to solve the model, such as the Standard GRG Engine.  In this example, however, we will use 6 conic constraints (one for each regional airline location) to calculate the distance between the airline hub and the regional airports. Removing the nonlinear functions and replacing them with conic constraints results in a SOCP Convex model which can be solved faster and more reliably with the SOCP engine.",
+  "modelType": "optimization",
+  "engineSettings": {
+    "comment": "Since this model uses conic constraints, the SOCP Barrier engine must be selected.  A simple example of a conic constraint is a non-negativity constraint on the decision variables.  A non-negativity constraint simply means that all variables must be greater than 0.  In this model, the variable blocks F21:F26, G21:G26 and H21:H26 must lie within a 2nd order cone (also called a Lorentz cone or 'ice cream cone'). This cone places a bound on the L2-norm of the vector of decision variables.  In this model, if the variables in cells F21:F26, G21:G26 and H21:H26 lie within a code, then FX >= SQRT(SUMSQ(GX:HX))",
+    "engine": "SOCP Barrier"
+  },
+  "variables": {
+    "comment": "There are 21 total variables in the model.",
+    "x": {
+      "comment": "The x variable represents the x coordinate of the proposed hub location.",
+      "value": 1.0,
+      "finalValue": []
+    },
+    "y": {
+      "comment": "The y variable represents the y coordinate of the proposed hub location.",
+      "value": 1.0,
+      "finalValue": []
+    },
+    "z": {
+      "comment": "The z variable is an artificial variable that will be used to 'squash' or incentivize RASON Decision Services to find a location for the hub that minimizes the distances between the hub and each regional airport.",
+      "value": 1.0,
+      "finalValue": []
+    },
+    "f21:f26": {
+      "comment": "These variables are new to the conic formulation.  These are required to setup the conic constraints, see below. Each set of three variables, for example F21:H21, must belong to a second order cone constraint (F21:H21 = conic) which can be rewritten as F21 >= SQRT(SUMSQ(G21:H21). The 6 conic constraints replace the nonlinear distance calculation in the C1, C2, C3, C4, C5 and C6 constraints in the AirlineHub model.",
+      "value": 1.0
+    },
+    "g21:g26": {
+      "comment": "These variables are new to the conic formulation.  These are required to setup the conic constraints, see below.",
+      "value": 1.0
+    },
+    "h21:h26": {
+      "comment": "These variables are new to the conic formulation.  These are required to setup the conic constraints, see below.",
+      "value": 1.0
+    }
+  },
+  "data": {
+    "comment": "The data section (optional) can be used to setup constant arrays or generate formulas to be utilized in the constraints and objective. ",
+    "corx": {
+      "comment": "This array contains the x coordinates for each regional airport.",
+      "dimensions": [ 6 ],
+      "value": [ 1, 0.5, 2, 2, 2, 0.5 ]
+    },
+    "cory": {
+      "comment": "This array contains the y coordinates for each regional airport.",
+      "dimensions": [ 6 ],
+      "value": [ 4, 3, 4, 2, 5, 6 ]
+    }
+  },
+  "constraints": {
+    "dx": {
+      "comment": "The differences between the x coordinates of the hub and each regional airport. This constraint is set equal to the new variables, G21:G26.",
+      "dimensions": [ 6 ],
+      "formula": "corx - x - g21:g26",
+      "lower": 0,
+      "upper": 0
+    },
+    "dy": {
+      "comment": "The differences between the y coordinates of the hub and each regional airport. This constraint is set equal to the new variables, H21:H26.",
+      "dimensions": [ 6 ],
+      "formula": "cory - y - h21:h26",
+      "lower": 0,
+      "upper": 0
+    },
+    "dz": {
+      "comment": "The effect of this constraint, coupled with the minimization of the z artificial variable, results in the artificial variable becoming equal to the maximum value in the f21:f26 variable array, in the final solution",
+      "dimensions": [ 6 ],
+      "formula": "f21:f26 - z",
+      "upper": 0
+    },
+    "cone1": {
+      "comment": "This comment applies to all 6 cone constraints, below.  Each set of 3 variables for example, F21, G21 and H21, must belong to a second order cone constraint which can be rewritten as F21 >= SQRT(SumSQ(G21:H21). These 6 conic constraints replace the nonlinear distance constraints in the original AirlineHub example.",
+      "value": "f21:h21",
+      "type": "cone"
+    },
+    "cone2": {
+      "comment": "cone constraint for f22, g22 and h22",
+      "value": "f22:h22",
+      "type": "cone"
+    },
+    "cone3": {
+      "comment": "cone constraint for f23, g23 and h23",
+      "value": "f23:h23",
+      "type": "cone"
+    },
+    "cone4": {
+      "comment": "cone constraint for f24, g24 and h24",
+      "value": "f24:h24",
+      "type": "cone"
+    },
+    "cone5": {
+      "comment": "cone constraint for f25, g25 and h25",
+      "value": "f25:h25",
+      "type": "cone"
+    },
+    "cone6": {
+      "comment": "cone constraint for f26, g26 and h26",
+      "value": "f26:h26",
+      "type": "cone"
+    }
+  },
+  "objective": {
+    "obj": {
+      "comment": "The objective, the z variable, is a decision variable being minimized. The effect of this variable being minimized, coupled with the dz constraint, results in the dz variable being equal to the max of F21:F26 variable values in the final solution.",
+      "formula": "z",
+      "type": "minimize",
+      "finalValue": []
+    }
+  }
 }

package/examples/{Optimization → optimization}/Conic/AirlineHubConic2.json

@@ -1,109 +1,109 @@
-{
-  "modelName": "AirlineHubConic2Example",
-  "modelDescription": "Airline Hub Conic 2 RASON Optimization Example: This model minimizes the distance between several regional airports and a proposed hub location. The difference between this example and the original AirlineHubConicExample is that this example uses vertical vectors. For a complete description of this model, see AirlineHubConic Example.",
-  "modelType": "optimization",
-  "engineSettings": {
-    "comment": "Since this model uses conic constraints, the SOCP Barrier engine must be selected.",
-    "engine": "SOCP Barrier"
-  },
-  "variables": {
-    "comment": "There are 21 total variables in the model.",
-    "x": {
-      "comment": "X coordinate of proposed hub.",
-      "value": 1.0,
-      "finalValue": []
-    },
-    "y": {
-      "comment": "Y coordinate of proposed hub.",
-      "value": 1.0,
-      "finalValue": []
-    },
-    "z": {
-      "comment": "Artificial z variable. Used in the objective that is being minimized.  The effect of this variable being minimized coupled with the constraint z >= f will result in cell z being equal to the maximum value in the f array, in the final solution.",
-      "value": 1.0,
-      "finalValue": []
-    },
-    "f": {
-      "comment": "Variables in the f, g and h arrays are required to setup the conic constraints, see below. Each set of three variables, for example F[1], G[1], H[1], must belong to a second order cone constraint which can be rewritten as F[1] >= SQRT(SUMSQ(G[1]:H[1]). The 6 conic constraints replace the nonlinear distance constraints in the AirlineHub example.",
-      "dimensions": [ 6 ],
-      "value": 1.0
-    },
-    "g": {
-      "dimensions": [ 6 ],
-      "value": 1.0
-    },
-    "h": {
-      "dimensions": [ 6 ],
-      "value": 1.0
-    }
-  },
-  "data": {
-    "comment": "The data section (optional) can be used to setup constant arrays or generate formulas to be utilized in the constraints and objective. ",
-    "corx": {
-      "comment": "This array contains the x coordinates for each regional airport.",
-      "dimensions": [ 6 ],
-      "value": [ 1, 0.5, 2, 2, 2, 0.5 ]
-    },
-    "cory": {
-      "comment": "This array contains the y coordinates for each regional airport.",
-      "dimensions": [ 6 ],
-      "value": [ 4, 3, 4, 2, 5, 6 ]
-    }
-  },
-  "constraints": {
-    "dx": {
-      "comment": "The differences between the x coordinates of the hub and each regional airport. This constraint is set equal to the g variables.",
-      "dimensions": [ 6 ],
-      "formula": "corx - x - g",
-      "lower": 0,
-      "upper": 0
-    },
-    "dy": {
-      "comment": "The differences between the y coordinates of the hub and each regional airport. This constraint is set equal to the h variables",
-      "dimensions": [ 6 ],
-      "formula": "cory - y - h",
-      "lower": 0,
-      "upper": 0
-    },
-    "dz": {
-      "comment": "The effect of this constraint, coupled with the minimization of the z artificial variable, results in the artificial variable becoming equal to the maximum value in the f[1]:f[6] variable array, in the final solution",
-      "dimensions": [ 6 ],
-      "formula": "f - z",
-      "upper": 0
-    },
-    "cone1": {
-      "comment": "This comment applies to all 6 cone constraints, below.  Each set of 3 variables for example, F[1], G[1] and H[1], must belong to a second order cone constraint which can be rewritten as F[1] >= SQRT(SumSQ(G[1]:H[1]). These 6 conic constraints replace the nonlinear distance calculation in the original AirlineHub example.",
-
-      "value": "f[1], g[1], h[1]",
-      "type": "cone"
-    },
-    "cone2": {
-      "value": "f[2], g[2], h[2]",
-      "type": "cone"
-    },
-    "cone3": {
-      "value": "f[3], g[3], h[3]",
-      "type": "cone"
-    },
-    "cone4": {
-      "value": "f[4], g[4], h[4]",
-      "type": "cone"
-    },
-    "cone5": {
-      "value": "f[5], g[5], h[5]",
-      "type": "cone"
-    },
-    "cone6": {
-      "value": "f[6], g[6], h[6]",
-      "type": "cone"
-    }
-  },
-  "objective": {
-    "obj": {
-      "comment": "The objective, the z variable, is a decision variable being minimized. The effect of this variable being minimized, coupled with the dz constraint, results in the z variable being equal to the max of F[1]:F[6] variable values in the final solution.",
-      "formula": "z",
-      "type": "minimize",
-      "finalValue": []
-    }
-  }
+{
+  "modelName": "AirlineHubConic2Example",
+  "modelDescription": "Airline Hub Conic 2 RASON Optimization Example: This model minimizes the distance between several regional airports and a proposed hub location. The difference between this example and the original AirlineHubConicExample is that this example uses vertical vectors. For a complete description of this model, see AirlineHubConic Example.",
+  "modelType": "optimization",
+  "engineSettings": {
+    "comment": "Since this model uses conic constraints, the SOCP Barrier engine must be selected.",
+    "engine": "SOCP Barrier"
+  },
+  "variables": {
+    "comment": "There are 21 total variables in the model.",
+    "x": {
+      "comment": "X coordinate of proposed hub.",
+      "value": 1.0,
+      "finalValue": []
+    },
+    "y": {
+      "comment": "Y coordinate of proposed hub.",
+      "value": 1.0,
+      "finalValue": []
+    },
+    "z": {
+      "comment": "Artificial z variable. Used in the objective that is being minimized.  The effect of this variable being minimized coupled with the constraint z >= f will result in cell z being equal to the maximum value in the f array, in the final solution.",
+      "value": 1.0,
+      "finalValue": []
+    },
+    "f": {
+      "comment": "Variables in the f, g and h arrays are required to setup the conic constraints, see below. Each set of three variables, for example F[1], G[1], H[1], must belong to a second order cone constraint which can be rewritten as F[1] >= SQRT(SUMSQ(G[1]:H[1]). The 6 conic constraints replace the nonlinear distance constraints in the AirlineHub example.",
+      "dimensions": [ 6 ],
+      "value": 1.0
+    },
+    "g": {
+      "dimensions": [ 6 ],
+      "value": 1.0
+    },
+    "h": {
+      "dimensions": [ 6 ],
+      "value": 1.0
+    }
+  },
+  "data": {
+    "comment": "The data section (optional) can be used to setup constant arrays or generate formulas to be utilized in the constraints and objective. ",
+    "corx": {
+      "comment": "This array contains the x coordinates for each regional airport.",
+      "dimensions": [ 6 ],
+      "value": [ 1, 0.5, 2, 2, 2, 0.5 ]
+    },
+    "cory": {
+      "comment": "This array contains the y coordinates for each regional airport.",
+      "dimensions": [ 6 ],
+      "value": [ 4, 3, 4, 2, 5, 6 ]
+    }
+  },
+  "constraints": {
+    "dx": {
+      "comment": "The differences between the x coordinates of the hub and each regional airport. This constraint is set equal to the g variables.",
+      "dimensions": [ 6 ],
+      "formula": "corx - x - g",
+      "lower": 0,
+      "upper": 0
+    },
+    "dy": {
+      "comment": "The differences between the y coordinates of the hub and each regional airport. This constraint is set equal to the h variables",
+      "dimensions": [ 6 ],
+      "formula": "cory - y - h",
+      "lower": 0,
+      "upper": 0
+    },
+    "dz": {
+      "comment": "The effect of this constraint, coupled with the minimization of the z artificial variable, results in the artificial variable becoming equal to the maximum value in the f[1]:f[6] variable array, in the final solution",
+      "dimensions": [ 6 ],
+      "formula": "f - z",
+      "upper": 0
+    },
+    "cone1": {
+      "comment": "This comment applies to all 6 cone constraints, below.  Each set of 3 variables for example, F[1], G[1] and H[1], must belong to a second order cone constraint which can be rewritten as F[1] >= SQRT(SumSQ(G[1]:H[1]). These 6 conic constraints replace the nonlinear distance calculation in the original AirlineHub example.",
+
+      "value": "f[1], g[1], h[1]",
+      "type": "cone"
+    },
+    "cone2": {
+      "value": "f[2], g[2], h[2]",
+      "type": "cone"
+    },
+    "cone3": {
+      "value": "f[3], g[3], h[3]",
+      "type": "cone"
+    },
+    "cone4": {
+      "value": "f[4], g[4], h[4]",
+      "type": "cone"
+    },
+    "cone5": {
+      "value": "f[5], g[5], h[5]",
+      "type": "cone"
+    },
+    "cone6": {
+      "value": "f[6], g[6], h[6]",
+      "type": "cone"
+    }
+  },
+  "objective": {
+    "obj": {
+      "comment": "The objective, the z variable, is a decision variable being minimized. The effect of this variable being minimized, coupled with the dz constraint, results in the z variable being equal to the max of F[1]:F[6] variable values in the final solution.",
+      "formula": "z",
+      "type": "minimize",
+      "finalValue": []
+    }
+  }
 }