owlplanner 2025.2.19__tar.gz → 2025.2.21__tar.gz

{owlplanner-2025.2.19 → owlplanner-2025.2.21}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: owlplanner
-Version: 2025.2.19
+Version: 2025.2.21
 Summary: Owl: Retirement planner with great wisdom
 Project-URL: HomePage, https://github.com/mdlacasse/owl
 Project-URL: Repository, https://github.com/mdlacasse/owl

{owlplanner-2025.2.19 → owlplanner-2025.2.21}/docs/owl.tex

@@ -160,7 +160,8 @@ Parameter values are either set by the user, historical data, or by the tax code
 		\gamma_n = \prod_{n' = 0}^{n-1} (1 + \tau_{3n'}),
 	\end{equation}
 	with $\gamma_0 := 1$, and where $n'$ is a dummy index.
-	As the time span of interest goes from the first year to the end of the last year,
+	As the time span of interest goes from the first year to the beginning
+        of the year following the last year,
         variable $\gamma_n$ will have $N_n + 1$ elements.
 	Parameters indexed for inflation will be indicated by a bar on top as in $\bar{\sigma}_n$.
 \item [$\sigma_n$]
@@ -218,7 +219,7 @@ Parameter values are either set by the user, historical data, or by the tax code
 	brackets are adjusted accordingly.
 \item [$\theta_{tn}$]
 	Tax rate for tax bracket $t$ in year $n$. Using $N_t$ time series allows to adjust income
-	tax rates in foreseeable future.
+	tax rates in the foreseeable future.
 	For example, in 2024 the rates (in decimal) are .10, .12, .22, .24, .32, .35, and .37.
 	It is speculated that the rates will revert back to 2017 rates in 2026 with
 	.10, .15, .25, .28, .33, .35, and .396. See Eq.~(\ref{Eq:IncTax0}) for its use.
@@ -286,8 +287,8 @@ or an s-curve as in
 	(e.g., sell a house, inheritance) or negative (e.g., buy a house, large gifts).
 \item [$\pi_{in}$]
 	Sum of pension benefits for individual $i$ in year $n$. These amounts are typically
-	specified along with the ages at which these benefits begin. Owl currently assumes
-	that pensions are not indexed for inflation, but that functionality can easily be added.
+	specified along with the ages at which these benefits begin. Pensions
+	can optionally be indexed for inflation.
 \item [$\zeta_{in}$]
 	Social security benefits for individual $i$ in year $n$. Starting age and the passing
 	of one individual for spouses will determine the time series. $\bar{\zeta}_{in}$ is
@@ -298,7 +299,8 @@ or an s-curve as in
 	for the heirs expressed in today's dollars. See parameter $\nu$ for the heirs tax rate.
 \item [$\kappa_{ijn}$]
 	Sum of contributions to savings account $j$ made by individual $i$ during year $n$.
-	We assume that contributions are made at half-year to balance regular contributions.
+	We assume that contributions are made at half-year to better represent periodic
+        contributions made throughout the year.
 	In practice, a contribution
 	amount $\kappa_{ijn}$ is specified in which case the contribution to each asset
 	class is
@@ -309,7 +311,7 @@ or an s-curve as in
 	Sum of wages obtained by individual $i$ during year $n$.
 	Do not confuse wages $\omega$ with withdrawals $w$.
 \item [$\mu$]
-	Dividend return rate in taxable accounts. Average is little above 2\% for S\&P 500.
+	Dividend return rate for equities in taxable accounts. Average is little above 2\% for S\&P 500.
 \item [$\nu$]
 	Heirs income tax rate to be applied on the tax-deferred portion of the estate. This is not an estate tax
 	but rather the federal income marginal tax rate for the heirs.
@@ -359,8 +361,8 @@ or an s-curve as in
 		\label{Eq:IRMAA}
 		\mathcal{M}_n = \sum_{iq} z_{iqn} \bar{C}_{qn}.
 	\end{equation}
-	If the plan does not have data from 2 years ago as Medicare starts,
-	it will use last year's or this year's MAGI instead, in that order.
+	If the plan needs data from 1 or 2 years ago as Medicare has already started or will in the next years,
+        values for years before current year need to be provided.
 
 	While this approach has been implemented and tested, the robustness of the {\em big M} approach
 	is not guaranteed. Moreover, the introduction of a large number ($5\times N_i\times N_m$,
@@ -409,7 +411,7 @@ All intermediate variables are in uppercase letters.
 
 \item [$Q_n$]
 	Qualified dividends and long-term capital gains obtained in year $n$.
-	They only involve gains occurring in taxable savings accounts $(j=0)$ that
+	They only involve dividends occurring in the taxable savings accounts $(j=0)$ that
 	were obtained from equities $(k=0)$, or sales of stocks due to withdrawals
 	from taxable savings accounts.
 	For simplicity, we assume that all equity sales only generate long-term capital gains and
@@ -422,10 +424,10 @@ All intermediate variables are in uppercase letters.
 	A formulation where only a fraction of dividends are qualified can easily be
 	implemented with the addition of another parameter.
 	Notice that we are using return rates from the previous year.
-	The first terms on the right-hand side represent the amount of equities $(k=0)$ in the $(j=0)$
-	taxable savings account plus
-	half the yearly contributions. The last terms account for withdrawals $w$ of equities assumed
-	to have been purchased a year ago. 
+	The first terms on the right-hand side represent dividends generated by
+        equities $(k=0)$ in the $(j=0)$ taxable savings account plus
+	half the yearly contributions. The second term account for withdrawals $w$
+        of equities assumed to have been purchased a year ago. 
 	It does not account for losses, but a market drop
 	would most likely result in stock purchase rather than sale.
 	For withdrawals, we make the assumption of
@@ -605,8 +607,7 @@ add the market returns to the savings balances.
 	if needed due to RMDs or receiving large sums of money,
 	could be made at the end of the year. Let's formulate this approach
 	in more detail and investigate for potential problems.
-	Timing controls which terms get multiplied by the rate of return $(1 + \tau_{kn})$
-	for a particular asset $k$.
+	Timing controls which terms get multiplied by the rate of return $(1 + \mathcal{T}_{ijn})$.
 	Therefore, our current choice would yield
 	\begin{eqnarray}
 		\label{Eq:C3a}

owlplanner-2025.2.21/examples/case_jon+jane.toml

@@ -0,0 +1,56 @@
+"Plan Name" = "Jon+Jane"
+
+["Basic Info"]
+Status = "married"
+Names = [ "Jon", "Jane",]
+"Birth year" = [ 1965, 1968,]
+"Life expectancy" = [ 92, 92,]
+"Start date" = "01-01"
+
+[Assets]
+"taxable savings balances" = [ 50.0, 0.0,]
+"tax-deferred savings balances" = [ 900.0, 500.0,]
+"tax-free savings balances" = [ 0.0, 0.0,]
+"Beneficiary fractions" = [ 1.0, 1.0, 1.0,]
+"Spousal surplus deposit fraction" = 0.0
+
+["Wages and Contributions"]
+"Contributions file name" = "edited values"
+
+["Fixed Income"]
+"Pension amounts" = [ 0.0, 0.0,]
+"Pension ages" = [ 65, 65,]
+"Pension indexed" = [ false, false,]
+"Social security amounts" = [ 21.0, 21.0,]
+"Social security ages" = [ 65, 65,]
+
+["Rates Selection"]
+"Heirs rate on tax-deferred estate" = 30.0
+"Long-term capital gain tax rate" = 15.0
+"Dividend tax rate" = 2.0
+"TCJA expiration year" = 2026
+Method = "user"
+Values = [ 10.0, 0.0, 0.0, 3.5000000000000004,]
+From = 1928
+To = 2024
+
+["Asset Allocation"]
+"Interpolation method" = "linear"
+"Interpolation center" = 15.0
+"Interpolation width" = 5.0
+Type = "individual"
+generic = [ [ [ 100, 0, 0, 0,], [ 100, 0, 0, 0,],], [ [ 100, 0, 0, 0,], [ 100, 0, 0, 0,],],]
+
+["Optimization Parameters"]
+"Spending profile" = "flat"
+"Surviving spouse spending percent" = 60
+Objective = "maxSpending"
+
+["Solver Options"]
+maxRothConversion = 0.0
+noRothConversions = "None"
+withMedicare = true
+bequest = 30.0
+
+[Results]
+"Default plots" = "today"

{owlplanner-2025.2.19 → owlplanner-2025.2.21}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "owlplanner"
-version = "2025.02.19"
+version = "2025.02.21"
 authors = [
   { name="Martin-D. Lacasse", email="martin.d.lacasse@gmail.com" },
 ]

{owlplanner-2025.2.19 → owlplanner-2025.2.21}/src/owlplanner/config.py

@@ -180,7 +180,7 @@ def readConfig(file, *, verbose=True, logstreams=None, readContributions=True):
     # status = diconf['Basic Info']['Status']
     yobs = diconf["Basic Info"]["Birth year"]
     expectancy = diconf["Basic Info"]["Life expectancy"]
-    startDate = diconf["Basic Info"]["Start date"]
+    startDate = diconf["Basic Info"].get("Start date", "today")
     icount = len(yobs)
     s = ["", "s"][icount - 1]
     mylog.vprint(f"Plan for {icount} individual{s}: {inames}.")
@@ -295,6 +295,11 @@ def readConfig(file, *, verbose=True, logstreams=None, readContributions=True):
     # Solver Options.
     p.solverOptions = diconf["Solver Options"]
 
+    # Check consistency of noRothConversions.
+    name = p.solverOptions.get("noRothConversions", "None")
+    if name != "None" and name not in p.inames:
+        raise ValueError(f"Unknown name {name} for noRothConversions.")
+
     # Results.
     p.setDefaultPlots(diconf["Results"]["Default plots"])
 

{owlplanner-2025.2.19 → owlplanner-2025.2.21}/src/owlplanner/plan.py

@@ -995,7 +995,7 @@ class Plan(object):
             self.DeltaBar_tn = self.Delta_tn * self.gamma_n[:-1]
             self.zetaBar_in = self.zeta_in * self.gamma_n[:-1]
             self.xiBar_n = self.xi_n * self.gamma_n[:-1]
-            self.piBar_in = self.pi_in
+            self.piBar_in = np.array(self.pi_in)
             for i in range(self.N_i):
                 if self.pensionIndexed[i]:
                     self.piBar_in[i] *= self.gamma_n[:-1]
@@ -2895,7 +2895,7 @@ def _stackPlot(x, inames, title, irange, series, snames, location, yformat="\\$k
 
     if len(nonzeroSeries) == 0:
         # print('Nothing to plot for', title)
-        return None
+        return None, None
 
     fig, ax = plt.subplots(figsize=(6, 4))
     plt.grid(visible="both")

owlplanner-2025.2.21/src/owlplanner/version.py

@@ -0,0 +1 @@
+__version__ = "2025.02.21"

{owlplanner-2025.2.19 → owlplanner-2025.2.21}/ui/Quick_Start.py

@@ -24,8 +24,9 @@ This file is in *toml* format which is editable with a simple text editor.
 time table with anticipated wages, future contributions
 to savings accounts, and anticipated big-ticket items, which can be either expenses or income.
 This file is in Excel or LibreOffice format, and has one tab per individual in the plan.
+If no file is provided, values will default to zero, but these values can be edited in the app.
 
-With these two files, a scenario can be created and solved in only a few steps. We will use the case
+With these two files, a scenario can be created and solved with only a few steps. We will use the case
 of Jack and Jill provided here as an example:
 1) Download these two files from the GitHub repository
  (right-click on the link and select `Save link as...`):
@@ -46,7 +47,7 @@ experiment with different parameters.
 
 For creating your own cases, you can start
 from scratch by selecting `New Case...` in the selection box while on the **Create Case** page,
-and fill in the information needed on each page of the `Case Setup` section.
+and fill in the information needed on each page in the `Case Setup` section.
 Once a case has been fully parameterized and successfully optimized,
 its parameters can be saved by using the `Download case file...` button on the `Output Files` page.
 

{owlplanner-2025.2.19 → owlplanner-2025.2.21}/ui/owlbridge.py

@@ -422,7 +422,8 @@ def plotSingleResults(plan):
         st.write("##### Assets Distribution")
         morecols = st.columns(3, gap="small")
         for fig in figs:
-            morecols[c].pyplot(fig)
+            if fig is not None:
+                morecols[c].pyplot(fig)
             c = (c + 1) % 3
 
 

{owlplanner-2025.2.19 → owlplanner-2025.2.21}/ui/requirements.txt

@@ -7,4 +7,4 @@ scipy
 streamlit
 toml
 # --extra-index-url https://test.pypi.org/simple
-owlplanner >= 2025.02.19
+owlplanner >= 2025.02.21

owlplanner-2025.2.19/src/owlplanner/version.py

@@ -1 +0,0 @@
-__version__ = "2025.02.19"