@frontlinesystems/rason-mcp-server 2026.5.0

package/examples/rason-features/BoxIterators/Box_Fun_Sim_RASON.json

@@ -0,0 +1,109 @@
+{
+    "modelName": "Box_Fun_Sim_Rason",
+    "modelDescription": "Box Function example that calculates a monthly loan payment for three unique loans.",
+    "modelType": "simulation",
+    "engineSettings": {
+        "numThreads": 1,
+        "randomGenerator": "Lecuyer",
+        "samplingMethod": "Latin"
+    },
+    "uncertainVariables": {
+        "comment": "Three uncertain variables that model the interest rate for each loan.",
+        "intRateCust1": {
+            "comment": "Models interest rate for 1st customer's loan.",
+            "formula": "PsiNormal(0.0375,0.1)"
+        },
+        "intRateCust2": {
+            "comment": "Models interest rate for 2nd customer's loan.",
+            "formula": "PsiNormal(0.0475,0.1)"
+        },
+        "intRateCust3": {
+            "comment": "Models interest rate for 3rd customer's loan.",
+            "formula": "PsiNormal(0.0575,0.1)"
+        }
+    },
+    "boxFunctions": {
+        "comment": "Includes 1 box function which calculates a customer's monthly loan payment based on the loan's principal (p), interest rate (r) and term (n). All input types must be numbers. Output type will also be a number.",
+        "funMonthlyPayment": {
+            "inputs": ["p", "r", "n"],
+            "inputTypes": ["number", "number", "number"],
+            "language": "Excel",
+            "resultType": "number",
+            "body": {
+                "payment": {
+                    "formula": "(p * r / 12) / (1 - (1 + r / 12)^-n)"
+                },
+                "fee": {
+                    "formula": "feePercent * payment"
+                }
+            },
+            "result": "payment + fee"
+        }
+    },
+    "data": {
+        "comment": "This section holds the loan data information, principal, term and fee percentage.",
+        "feePercent": {
+            "comment": "Fee percentage",
+            "value": 0.01
+        },
+        "loan1Princ": {
+        "comment": "Principal amount for loan 1.",
+            "value": 600000
+        },
+        "loan1Term": {
+            "comment": "Term length for loan 1.",
+            "value": 360
+        },
+        "loan2Princ": {
+            "comment": "Principal amount for loan 2.",
+            "value": 550000
+        },
+        "loan2Term": {
+            "comment": "Term length for loan 2.",
+            "value": 360
+        },
+        "loan3Princ": {
+            "comment": "Principal amount for loan 3.",
+            "value": 500000
+        },
+        "loan3Term": {
+            "comment": "Term length for loan 3.",
+            "value": 360
+        }
+    },
+    "formulas": {
+        "cust1MonthlyPayment": {
+            "comment": "Passes the information for the 1st customer's loan to the funMonthlyPayment box function (above).",
+            "formula": "funMonthlyPayment(loan1Princ, intRateCust1, loan1Term) + PsiOutput()"
+        },
+        "cust2MonthlyPayment": {
+            "comment": "Passes the information for the 2nd customer's loan to the funMonthlyPayment box function (above).",
+            "formula": "funMonthlyPayment(loan2Princ, intRateCust2, loan2Term) + PsiOutput()"
+        },
+        "cust3MonthlyPayment": {
+            "comment": "Passes the information for the 3rd customer's loan to the funMonthlyPayment box function (above).",
+            "formula": "funMonthlyPayment(loan3Princ, intRateCust3, loan3Term) + PsiOutput()"
+        }
+    },
+    "uncertainFunctions": {
+        "comment": "This section holds the uncertain functions in the simulation model.",
+        "uncFunc1": {
+            "comment": "Transforms the cust1MonthlyPayment formula into an uncertain function, providing results from all 1000 simulation trials along with the mean of these trials.",
+            "formula": "cust1MonthlyPayment",
+            "trials": [],
+            "mean": []
+        },
+        "uncFunc2": {
+            "comment": "Transforms the cust1MonthlyPayment formula into an uncertain function, providing results from all 1000 simulation trials along with the mean of these trials.",
+            "formula": "cust2MonthlyPayment",
+            "trials": [],
+            "mean": []
+        },
+        "uncFunc3": {
+            "comment": "Transforms the cust1MonthlyPayment formula into an uncertain function, providing results from all 1000 simulation trials along with the mean of these trials.",
+            "formula": "cust3MonthlyPayment",
+            "trials": [],
+            "mean": []
+        }
+    }
+}

package/examples/rason-features/BoxIterators/Box_Iter_SIM_RASON.json

@@ -0,0 +1,69 @@
+{
+    "modelName": "Box_Iter_Sim_Rason",
+    "modelDescription": "Box Iterator example that calculates a monthly loan payment for three unique loans.",
+    "modelType": "simulation",
+    "engineSettings": {
+        "numThreads": 1,
+        "randomGenerator": "Lecuyer",
+        "samplingMethod": "Latin"
+    },
+    "uncertainVariables": {
+        "comment": "Three uncertain variables that model the interest rate for each loan.",
+        "rate": {
+            "comment": "Each uncertain variable is an element of the rate array: rate[1] models interest rate of 1st loan, rate[2] models interest rate of 2nd loan and rate[3] models interest rate of 3rd loan.",
+            "dimensions": [3],
+            "value": ["PsiNormal(0.0375, 0.1)", "PsiNormal(0.0475, 0.1)", "PsiNormal(0.0575, 0.1)"]
+        }
+    },
+    "boxIterators": {
+        "comment": "Use the boxIterator section when entering box iterators. Includes 1 box function which calculates a customer's monthly loan payment based on the loan's principal (amount), interest rate (rate) and term (term). Output type will also be a number.",
+        "iterMonthlyPayment": {
+            "language": "Excel",
+            "returnType": "number",
+            "for": "i",
+            "in": "1..rows(amount)",
+            "return": "((amount[i] * rate[i] /12) / (1 - (1 + rate[i]/12)^-term[i])) * (1 + feePercent)"
+        }
+    },
+    "data": {
+        "comment": "This section holds the loan data: principals, terms and fee percentage.",
+        "feePercent": {
+            "comment": "Fee percentage",
+            "value": 0.01
+        },
+        "amount": {
+            "comment": "Principal amounts for each loan:  amount[1] = principal for loan 1, amount[2] = principal for loan 2, amount[3] = principal for loan 3. ",
+            "value": [600000, 550000, 500000]
+        },
+        "term": {
+            "comment": "Terms for each loan:  term[1] = term for loan 1, term[2] = term for loan 2, term[3] = term for loan 3. ",
+            "value": [360, 360, 360]
+        }
+    },
+    "formulas": {
+        "comment": "Calls the box iterator above with the data to compute monthly payments for each loan.",
+        "callingBoxIterator": {
+            "formula": "iterMonthlyPayment()"
+        }
+    },
+    "uncertainFunctions": {
+        "uncFunc7": {
+            "comment": "Uncertain function returns expected value, or mean, for the monthly payment of 1st loan.",
+            "formula": "callingBoxIterator[1]",
+            "trials": [],
+            "mean": []
+        },
+        "uncFunc8": {
+            "comment": "Uncertain function returns expected value, or mean, for the monthly payment of 2nd loan.",
+            "formula": "callingBoxIterator[2]",
+            "trials": [],
+            "mean": []
+        },
+        "uncFunc9": {
+            "comment": "Uncertain function returns expected value, or mean, for the monthly payment of 3rd loan.",
+            "formula": "callingBoxIterator[3]",
+            "trials": [],
+            "mean": []
+        }
+    }
+}

package/examples/rason-features/BoxIterators/Box_Iterator_Calc_Loop.json

@@ -0,0 +1,183 @@
+{
+  "modelName": "Calc_Box_Fcn_and_Box_Iters",
+  "modelDescription": "This example includes 1 box function and 4 box iterators. Each one calculates the monthly payments of 3 loans.",
+  "modelType": "calculation",
+  "boxFunctions": {
+    "comment": "Box Function that calculates the monthly payment of 3 loans. This box function accepts 3 inputs:  p - principal, r - interest rate and n - loan term length.  All inputs must be numbers (see inputTypes). The returned result will also be a number (see resultType).  See loan1Pmt, loan2Pmt and loan3Pmt, under formulas (below), to see how to pass the arguments to the function.",
+    "funMonthlyPayment": {
+      "inputs": [ "p", "r", "n" ],
+      "inputTypes": [ "number", "number", "number" ],
+      "language": "Excel",
+      "resultType": "number",
+      "body": {
+        "payment": {
+          "formula": "(p * r / 12) / (1 - (1 + r / 12)^-n)"
+        },
+        "fee": {
+          "formula": "feePercent * payment"
+        }
+      },
+      "result": "payment + fee"
+    }
+  },
+  "boxIterators": {
+    "comment": "There are 4 box iterators: iterMonthlyPayment (example of a box iterator of type FOR, using language EXCEL), iterPaymentSome (example of a box iterator of type SOME) iterPaymentEvery (example of a box iterator of type EVERY) and iterPaymentFEEL (example of a box iterator using FEEL Language)",
+    "iterMonthlyPayment": {
+      "comment": "This box iterator uses language Excel and type FOR to calculate the monthly payment for 3 loans. A FOR type of box iterator executes a traditional For Loop. This iterator accepts three inputs, amount[i], rate[i] and term[i] and returns the monthly payment plus a small fee.",
+      "language": "Excel",
+      "returnType": "",
+      "for": "i",
+      "in": "1..rows(amount)",
+      "body": {
+        "payment": {
+          "formula": "(amount[i] * rate[i] /12) / (1 - (1 + rate[i]/12)^-term[i])"
+        },
+        "fee": {
+          "formula": "feePercent * payment"
+        }
+      },
+      "return": "payment + fee"
+    },
+    "iterPaymentSome": {
+      "comment": "This box iterator uses language Excel and type SOME. The SOME type of box iterator, verifies if at least one computed element of the loop is True.  If so, the box iterator will return True. This iterator accepts three inputs, amount[i], rate[i] and term[i] and returns the monthly payment plus a small fee.",
+      "language": "Excel",
+      "returnType": "",
+      "some": "i",
+      "in": "1..rows(amount)",
+      "body": {
+        "payment": {
+          "formula": "(amount[i] * rate[i] /12) / (1 - (1 + rate[i]/12)^-term[i])"
+        },
+        "fee": {
+          "formula": "feePercent * payment"
+        }
+      },
+      "return": "(payment + fee) > 2900"
+    },
+    "iterPaymentEvery": {
+      "comment": "This box iterator uses language Excel and EVERY. The EVERY type of box iterator, verifies if at all computed elements of the loop are True.  If so, the box iterator will return True. This iterator accepts three inputs, amount[i], rate[i] and term[i] and returns the monthly payment plus a small fee.",
+      "language": "Excel",
+      "returnType": "",
+      "every": "i",
+      "in": "1..rows(amount)",
+      "body": {
+        "payment": {
+          "formula": "(amount[i] * rate[i] /12) / (1 - (1 + rate[i]/12)^-term[i])"
+        },
+        "fee": {
+          "formula": "feePercent * payment"
+        }
+      },
+      "return": "(payment + fee) > 2900"
+    },
+    "iterPaymentFeel": {
+      "comment": "This box iterator uses language FEEL and type FOR. The FOR type of box iterator executes a traditional FOR loop. This iterator accepts three inputs, amount[i], rate[i] and term[i] and returns the monthly payment plus a small fee.",
+      "language": "Feel",
+      "returnType": "",
+      "for": "rate",
+      "in": "[0.0375, 0.0475, 0.0575]",
+      "body": {
+        "payment": {
+          "formula": "(600000 * rate /12) / (1 - (1 + rate/12)**-360)"
+        },
+        "fee": {
+          "formula": "0.01 * payment"
+        }
+      },
+      "return": "payment + fee"
+    }
+  },
+  "data": {
+    "comment": "Holds all constant data arrays.",
+    "feePercent": {
+      "comment": "fee percentage",
+      "value": 0.01
+    },
+    "loan1Princ": {
+      "comment": "Loan 1 principal",
+      "value": 600000
+    },
+    "loan1Rate": {
+      "comment": "Loan 1 interest rate",
+      "value": 0.0375
+    },
+    "loan1Term": {
+      "comment": "Loan 1 term",
+      "value": 360
+    },
+    "loan2Princ": {
+      "comment": "Loan 2 principal",
+      "value": 550000
+    },
+    "loan2Rate": {
+      "comment": "Loan 2 interest rate",
+      "value": 0.0475
+    },
+    "loan2Term": {
+      "comment": "Loan 2 term",
+      "value": 360
+    },
+    "loan3Princ": {
+      "comment": "Loan 3 principal",
+      "value": 500000
+    },
+    "loan3Rate": {
+      "comment": "Loan 3 interest rate",
+      "value": 0.0575
+    },
+    "loan3Term": {
+      "comment": "Loan 3 term",
+      "value": 360
+    },
+    "amount": {
+      "comment": "Array containing principal amounts for all three loans. Loan 1 = amount[1] = 600000",
+      "value": [ 600000, 550000, 500000 ]
+    },
+    "rate": {
+      "comment": "Array containing interest rate amounts for all three loans. Interest rate for loan 1 = rate[1] = 0.0375",
+      "value": [ 0.0375, 0.0475, 0.0575 ]
+    },
+    "term": {
+      "comment": "Array containing term lengths for all three loans. Loan 1 term = term[1] = 360",
+      "value": [ 360, 360, 360 ]
+    }
+  },
+  "formulas": {
+    "comment": "Contains all formulas calling the box function and box iterators.",
+    "loan1Pmt": {
+      "comment": "Calls the funMonthlyPayment box function with three arguments, loan1Princ, loan1Rate and loan1Term, to calculate the monthly payment for loan 1.",
+      "formula": "funMonthlyPayment(loan1Princ, loan1Rate, loan1Term)",
+      "finalValue": []
+    },
+    "loan2Pmt": {
+      "comment": "Calls the funMonthlyPayment box function with three arguments, loan2Princ, loan2Rate and loan2Term, to calculate the monthly payment for loan 2.",
+      "formula": "funMonthlyPayment(loan2Princ, loan2Rate, loan2Term)",
+      "finalValue": []
+    },
+    "loan3Pmt": {
+      "comment": "Calls the funMonthlyPayment box function with three arguments, loan3Princ, loan3Rate and loan3Term, to calculate the monthly payment for loan 3.",
+      "formula": "funMonthlyPayment(loan3Princ, loan3Rate, loan3Term)",
+      "finalValue": []
+    },
+    "monthlyLoanPMT": {
+      "comment": "Calls the iterMonthlyPayment box iterator.",
+      "formula": "iterMonthlyPayment()",
+      "finalValue": []
+    },
+    "boxIterTypeSome": {
+      "comment": "Calls the iterPaymentSome box iterator.",
+      "formula": "iterPaymentSome()",
+      "finalValue": []
+    },
+    "boxIterTypeEvery": {
+      "comment": "Calls the iterPaymentEvery box iterator.",
+      "formula": "iterPaymentEvery()",
+      "finalValue": []
+    },
+    "boxIterLangFEEL": {
+      "comment": "Calls the iterPaymentFeel box iterator.",
+      "formula": "iterPaymentFeel()",
+      "finalValue": []
+    }
+  }
+}

package/examples/rason-features/BoxIterators/Box_Iterator_with_typeDef_partial.json

@@ -0,0 +1,79 @@
+{
+  "modelName": "BoxIter_FEELwithTypeDef",
+	"modelDescription": "Example of box iterator using FEEL language",
+	"modelType": "calculation",
+
+    "typeDefs": {
+
+	"tLoan": {
+	    "components": {
+	    	"principal":  { "type": "number", "allowedValues": [">0"] },
+	    	"rate":       { "type": "number", "allowedValues": ["[0..1]"] },
+	    	"termMonths": { "type": "number", "allowedValues": [">0"] }
+	    },
+	    "language": "Excel"
+	},
+	"tLoanList": {
+	    "language": "Excel", "typeRef": "tLoan", "isCollection": true
+	},
+	"tPayment": {
+	    "language": "Excel",
+	    "components": ["payment","fee","total"], "types": ["number","number","number"]
+	},
+	"tPaymentList": {
+	    "language": "Excel", "typeRef": "tPayment", "isCollection": true
+	}
+    },
+
+    "boxFunctions": {
+
+	"funPMT": {
+		"inputs": ["p", "r", "n"], "inputTypes": ["number", "number", "number"],
+
+		"language": "Excel", "returnType": "tPayment",
+
+		"body": {
+			"payment": { "formula": "(p*r/12) / (1 - (1 + r/12)^-n)" },
+			"fee":	   { "formula": "0.01 * payment" },
+			"total":   { "formula": "payment + fee" }
+		},
+		"return": "0"
+	}
+    },
+
+    "boxIterators": {
+
+	"forPMT": {
+		"language": "Excel", "returnType": "tPayment",
+
+		"for": "loan", "in": "loans",
+
+		"body": {
+			"payment": { "formula": "(loan.principal*loan.rate/12) / (1 - (1 + loan.rate/12)^-loan.termMonths)" },
+			"fee":	   { "formula": "0.01 * payment" },
+			"total":   { "formula": "payment + fee" }
+		},
+		"return": "total"
+	},
+	"forFac": {
+		"language": "Feel", "returnType": "number",
+
+		"for": "i", "in": "0..N",
+
+		"return": "if i = 0 then 1 else i * partial[-1]"
+	}
+    },
+
+    "data": {
+	"N":	 { "value": 4, "binding": "get" },
+
+	"loans": { "type": "tLoanList", "value": [[600000, 0.0375, 360],[100000, 0.0375, 360]], "binding": "get" }
+    },
+
+    "formulas": {
+
+	"MonthlyPayment": { "feelFormula": "forPMT()", "finalValue": [] },
+
+	"Factorials": 	  { "feelFormula": "forFac()", "finalValue": [] }
+    }
+}

package/examples/rason-features/BoxLambdaExamples/BoxFunOptimize.json

@@ -0,0 +1,155 @@
+{
+  "comment": "This model has been generated by Psi from an Excel model in the workbook Book7",
+  "modelName": "BoxFunOptimize",
+  "modelDescription": "This Box Function calculates the distance function based on 4 inputs x1, x2 and y1, y2. A Box function is a custom, reusable function. This example solves an optimization model using the funDistance box function to calculate the distance between a proposed airline hub and six regional airports.",
+  "modelType": "optimization",
+  "engineSettings": {
+    "comment": "The GRG Nonlinear engine is selected to solve the model.",
+    "engine": "GRG Nonlinear",
+    "scaling": -1
+  },
+  "boxFunctions": {
+    "funDistance": {
+      "comment": "The 'funDistance' box function calculates the distance between two points.",
+      "inputs": [ "Xone", "Xtwo", "Yone", "Ytwo" ],
+      "inputTypes": [ "number", "number", "number", "number" ],
+      "language": "EXCEL",
+      "resultType": "number",
+      "body": {
+        "formula1": {
+          "formula": "(Xtwo-Xone)^2"
+        },
+        "formula2": {
+          "formula": "(Ytwo-Yone)^2"
+        }
+      },
+      "result": "SQRT(Formula1+Formula2)"
+    }
+  },
+  "variables": {
+    "comment": "There are 3 decision variables in the model.  E13 and F13 are the x and y coordinates of the proposed airline hub. G20 is an artificial variable. The objective function minimizes the G20 variable which has a squashing effect on the distance calculations. In the final solution, G20 will equal the maximum value of the six distance calculations.",
+    "e13:f13": {
+      "comment": "Two variables, x and y, the coordinates of the proprosed hub.",
+      "value": 1,
+      "finalValue": []
+    },
+    "g20": {
+      "comment": "Artifical variable that will be mimimized in the objective.",
+      "value": 1,
+      "finalValue": []
+    }
+  },
+  "data": {
+    "comment": "x and y coordinates for each regional airport; E14 and F14 1st regional airport coordinates, E15 and F15 2nd regional airport coordinates, etc.",
+    "e14": {
+      "comment": "x coordinate for 1st regional airport",
+      "value": 6
+    },
+    "f14": {
+      "comment": "y coordinate for 1st regional airport",
+      "value": 2
+    },
+    "e15": {
+      "comment": "x coordinate for 2nd regional airport",
+      "value": 5
+    },
+    "f15": {
+      "comment": "y coordinate for 2nd regional airport",
+      "value": 5
+    },
+    "e16": {
+      "comment": "x coordinate for 3rd regional airport",
+      "value": 4
+    },
+    "f16": {
+      "comment": "y coordinate for 3rd regional airport",
+      "value": 8
+    },
+    "e17": {
+      "comment": "x coordinate for 4th regional airport",
+      "value": 3
+    },
+    "f17": {
+      "comment": "y coordinate for 4th regional airport",
+      "value": 4
+    },
+    "e18": {
+      "comment": "x coordinate for 5th regional airport",
+      "value": 3
+    },
+    "f18": {
+      "comment": "y coordinate for 5th regional airport",
+      "value": 3
+    },
+    "e19": {
+      "comment": "x coordinate for 6th regional airport",
+      "value": 1
+    },
+    "f19": {
+      "comment": "y coordinate for 6th regional airport",
+      "value": 2
+    }
+  },
+  "formulas": {
+    "comment": "Calls the box function, funDistance, to calculate the distance between the proposed hub and of the 6 regional airports.",
+    "g14": {
+      "comment": "Calculates distance between proposed hub location and the 1st regional airport.",
+      "formula": "funDistance($E$13,E14,$F$13,F14)"
+    },
+    "g15": {
+      "comment": "Calculates distance between proposed hub location and the 2nd regional airport.",
+      "formula": "funDistance($E$13,E15,$F$13,F15)"
+    },
+    "g16": {
+      "comment": "Calculates distance between proposed hub location and the 3rd regional airport.",
+      "formula": "funDistance($E$13,E16,$F$13,F16)"
+    },
+    "g17": {
+      "comment": "Calculates distance between proposed hub location and the 4th regional airport.",
+      "formula": "funDistance($E$13,E17,$F$13,F17)"
+    },
+    "g18": {
+      "comment": "Calculates distance between proposed hub location and the 5th regional airport.",
+      "formula": "funDistance($E$13,E18,$F$13,F18)"
+    },
+    "g19": {
+      "comment": "Calculates distance between proposed hub location and the 6th regional airport.",
+      "formula": "funDistance($E$13,E19,$F$13,F19)"
+    }
+  },
+  "constraints": {
+    "comment": "Six constraints of the form, SQRT((y2-y1)+(x2-x1)) - G20 <= 0.",
+    "g14_": {
+      "formula": "g14 - g20",
+      "upper": 0
+    },
+    "g15_": {
+      "formula": "g15 - g20",
+      "upper": 0
+    },
+    "g16_": {
+      "formula": "g16 - g20",
+      "upper": 0
+    },
+    "g17_": {
+      "formula": "g17 - g20",
+      "upper": 0
+    },
+    "g18_": {
+      "formula": "g18 - g20",
+      "upper": 0
+    },
+    "g19_": {
+      "formula": "g19 - g20",
+      "upper": 0
+    }
+  },
+  "objective": {
+    "comment": "Minimizing the artificial variable, G20. In the final solution, the value of the G20 variable will equal the maximim value of the six distance calculations, in this example, the box function values.",
+    "objective": {
+      "formula": "g20",
+      "type": "min",
+      "finalValue": []
+    }
+  }
+}