This function does series of loans, as opposed to a single loan like Loan and LoanX. The difference between a single loan with multiple NetAdvances and series of mini-loans, each absorbing one of the NetAdvances, is:
The usefulness of this function is in engineering a planned fiancing line in a cashflow, where you don"t want to go to the trouble (and calculation overhead) of lots of Loans. Where this function was used for the first time to great effect was in doing just that - boiling several loans down to, effectively one.
- Each mini-loan can different a different Term (Term_s), and can have a different margin (via AddMargin_s).
- Each mini-loan can have its own time geometry, in terms of interest frequency (via PmtsPerYr_s), and the start date of the first interest payment (StartingSeqNum_s if specified, otherwise its the advance date).
Pluralable "_s" variables
This function has several variables that either accept a single value or a range of values. If a single value is specified, then that value is used for all the mini-loans (each of the NetAdvances. If a number of values are specified then each value is used against the corresponding value in NetAdvances and each mini-loan can have its own characteristics in terms of term, payments per year, etc. If the number of values in a pluralable variable is more than one but less than the total number of the NetAdvances then the values in the plural variable are used against the corresponding value in NetAdvances until they run out - then the final value is used for all future NetAdvances.
StartingSeqNum_s and PmtsPerYr_s
This function does not have a Periods variable, unlike most other loan or projectons functions. Periods in a loan function is used to define the periods over which interest accrues and is paid. In LoanPool, each loan needs to create its own payment schedule (or Periods) internally. It does this my looking at the AdvanceDate and uses PmtsPerYr to generate regular periods starting on the AdvanceDate. However, if you want to specify the payment periods more closely, and don"t want day 1 of the mini-loan to be an interest payment date (say, you want a short stub period), you can use StartingSeqNum_s to specify the first interest payment date in the form mm.dd (eg 7.01). It is a pluralable variable, so you can even have a different one for each mini-loan.