# Iterative proportional fitting

The iterative proportional fitting procedure (IPF or IPFP, also known as biproportional fitting or biproportion in statistics or economics (input-output analysis, etc.), RAS algorithm in economics, raking in survey statistics, and matrix scaling in computer science) is the operation of finding the fitted matrix $X$ which is the closest to an initial matrix $Z$ but with the row and column totals of a target matrix $Y$ (which provides the constraints of the problem; the interior of $Y$ is unknown). The fitted matrix being of the form $X=PZQ$, where $P$ and $Q$ are diagonal matrices such that $X$ has the margins (row and column sums) of $Y$. Some algorithms can be chosen to perform biproportion. We have also the entropy maximization, information loss minimization (or cross-entropy) or RAS which consists of factoring the matrix rows to match the specified row totals, then factoring its columns to match the specified column totals; each step usually disturbs the previous step's match, so these steps are repeated in cycles, re-adjusting the rows and columns in turn, until all specified marginal totals are satisfactorily approximated. However, all algorithms give the same solution. In three- or more-dimensional cases, adjustment steps are applied for the marginals of each dimension in turn, the steps likewise repeated in cycles.

## History

IPF has been "re-invented" many times, the earliest by Kruithof in 1937 in relation to telephone traffic ("Kruithof’s double factor method"), Deming and Stephan in 1940 for adjusting census crosstabulations, and G.V. Sheleikhovskii for traffic as reported by Bregman. (Deming and Stephan proposed IPFP as an algorithm leading to a minimizer of the Pearson X-squared statistic, which Stephan later reported it does not). Early proofs of uniqueness and convergence came from Sinkhorn (1964), Bacharach (1965), Bishop (1967), and Fienberg (1970). Bishop's proof that IPFP finds the maximum likelihood estimator for any number of dimensions extended a 1959 proof by Brown for 2x2x2... cases. Fienberg's proof by differential geometry exploits the method's constant crossproduct ratios, for strictly positive tables. Csiszár (1975). found necessary and sufficient conditions for general tables having zero entries. Pukelsheim and Simeone (2009) give further results on convergence and error behavior.
An exhaustive treatment of the algorithm and its mathematical foundations can be found in the book of Bishop et al. (1975). Idel (2016) gives a more recent survey.
Other general algorithms can be modified to yield the same limit as the IPFP, for instance the Newton–Raphson method and the EM algorithm. In most cases, IPFP is preferred due to its computational speed, low storage requirements, numerical stability and algebraic simplicity.
Applications of IPFP have grown to include trip distribution models, Fratar or Furness and other applications in transportation planning (Lamond and Stewart), survey weighting, synthesis of cross-classified demographic data, adjusting input–output models in economics, estimating expected quasi-independent contingency tables, biproportional apportionment systems of political representation, and for a preconditioner in linear algebra.

## Biproportion

Biproportion, whatever the algorithm used to solve it, is the following concept: $Z$, matrix $Y$ and matrix $X$ are known real nonnegative matrices of dimension $n,m$; the interior of $Y$ is unknown and $X$ is searched such that $X$ has the same margins than $Y$, i.e. $Xs=Ys$ and $s'X=s'Y$ ($s$ being the sum vector), and such that $X$ is close to $Z$ following a given criterion, the fitted matrix being of the form $X=K(Z,Y)=PZQ$, where $P$ and $Q$ are diagonal matrices.
$min\sum _{i}\sum _{j}x_{ij}\log(x_{ij}/z_{ij})$ s.t.$\sum _{j}x_{ij}=y_{i.}$, ∀$i$ and $\sum _{i}x_{ij}=y_{.j}$, ∀$j$. The Lagrangian is $L=\sum _{i}\sum _{j}x_{ij}\log(x_{ij}/z_{ij})-\sum _{i}p_{i}(y_{i.}-\sum _{j}x_{ij})-\sum _{j}q_{j}(y_{.j}-\sum _{i}x_{ij})$.
Thus $x_{ij}=z_{ij}\exp -(1+p_{i}+q_{j})$, for ∀$i,j$,
which, after posing $P_{i}=\exp -(1+p_{i})$ and $Q_{j}=\exp -q_{j}$, yields
$x_{ij}=P_{i}z_{ij}Q_{j}$, ∀$i,j$, i.e., $X=PZQ$,
with $P_{i}=y_{i.}(\sum _{j}z_{ij}Q_{j})^{-1}$, ∀$i$ and $Q_{j}=y_{.j}(\sum _{i}z_{ij}P_{i})^{-1}$, ∀$j$. $P_{i}$ and $Q_{j}$ form a system that can be solve iteratively:
$P_{i}^{(t+1)}=y_{i.}(\sum _{j}z_{ij}Q_{j}^{(t)})^{-1}$, ∀$i$ and $Q_{j}^{(t+1)}=y_{.j}(\sum _{i}z_{ij}P_{i}^{(t+1)})^{-1}$, ∀$j$.
The solution $X$ is independent of the initialization chosen (i.e., we can begin by $q_{j}^{(0)}=1$, ∀$j$ or by $p_{i}^{(0)}=1$, ∀$i$. If the matrix $Z$ is “indecomposable”, then this process has a unique fixed-point because it is deduced from a program where the function is a convex and continuously derivable function defined on a compact set. In some cases the solution may not exist: see de Mesnard's example cited by Miller and Blair (Miller R.E. & Blair P.D. (2009) Input-output analysis: Foundations and Extensions, Second edition, Cambridge (UK): Cambridge University Press, p. 335-336 (freely available)).
Some properties (see de Mesnard (1994)):
Lack of information: if $Z$ brings no information, i.e., $z_{ij}=z$, ∀$i,j$ then $X=PQ$.
Idempotency: $X=K(Z,Y)=Z$ if $Y$ has the same margins than $Z$.
Composition of biproportions: $K(K(Z,Y_{1}),Y_{2}=K(Z,Y_{2})$; $K(...K(Z,Y_{1}),Y_{2})...Z_{N})=K(Z,Y_{N})$.
Zeros: a zero in $Z$ is projected as a zero in $X$. Thus, a bloc-diagonal matrix is projected as a bloc-diagonal matrix and a triangular matrix is projected as a triangular matrix.
Theorem of separable modifications: if $Z$ is premutiplied by a diagonal matrix and/or postmultiplied by a diagonal matrix, then the solution is unchanged.
Theorem of "unicity": If $K^{q}$ is any non-specified algorithm, with ${\hat {X}}=K^{q}(Z,Y)=UZV$, $U$ and $V$ being unknown, then $U$ and $V$ can always be changed into the standard form of $P$ and $Q$. The demonstrations calls some above properties, particularly the Theorem of separable modifications and the composition of biproportions.

## Algorithm 1 (classical IPF)

Given a two-way (I × J)-table $x_{ij}$, we wish to estimate a new table ${\hat {m}}_{ij}=a_{i}b_{j}x_{ij}$ for all i and j such that the marginals satisfy $\sum _{j}{\hat {m}}_{ij}\ =u_{i},$ and $\sum _{i}{\hat {m}}_{ij}\ =v_{j}$.
Choose initial values ${\hat {m}}_{ij}^{(0)}:=x_{ij}$, and for $\eta \geq 1$ set
    ${\hat {m}}_{ij}^{(2\eta -1)}={\frac {{\hat {m}}_{ij}^{(2\eta -2)}u_{i}}{\sum _{k=1}^{J}{\hat {m}}_{ik}^{(2\eta -2)}}}$
    ${\hat {m}}_{ij}^{(2\eta )}={\frac {{\hat {m}}_{ij}^{(2\eta -1)}v_{j}}{\sum _{k=1}^{I}{\hat {m}}_{kj}^{(2\eta -1)}}}.$
Repeat these steps until row and column totals are sufficiently close to u and v.
Notes:
* For the RAS form of the algorithm, define the diagonalization operator $diag:\mathbb {R} ^{k}\longrightarrow \mathbb {R} ^{k\times k}$, which produces a (diagonal) matrix with its input vector on the main diagonal and zero elsewhere. Then, for each row adjustment, let $R^{\eta }=diag({\frac {u_{i}}{\sum _{j}m_{ij}^{(2\eta -2)}}})$, from which $M^{2\eta -1}=R^{\eta }M^{2\eta -2}$. Similarly each column adjustment's $S^{\eta }=diag({\frac {v_{i}}{\sum _{i}m_{ij}^{(2\eta -1)}}})$, from which $M^{2\eta }=M^{2\eta -1}S^{\eta }$. Reducing the operations to the necessary ones, it can easily be seen that RAS does the same as classical IPF. In practice, one would not implement actual matrix multiplication with the whole R and S matrices; the RAS form is more a notational than computational convenience.

## Algorithm 2 (factor estimation)

Assume the same setting as in the classical IPFP. Alternatively, we can estimate the row and column factors separately: Choose initial values ${\hat {b}}_{j}^{(0)}:=1$, and for $\eta \geq 1$ set
    ${\hat {a}}_{i}^{(\eta )}={\frac {u_{i}}{\sum _{j}\ x_{ij}{\hat {b}}_{j}^{(\eta -1)}}},$
    ${\hat {b}}_{j}^{(\eta )}={\frac {v_{j}}{\sum _{i}\ x_{ij}{\hat {a}}_{i}^{(\eta )}}}$
Repeat these steps until successive changes of a and b are sufficiently negligible (indicating the resulting row- and column-sums are close to u and v).
Finally, the result matrix is ${\hat {m}}_{ij}={\hat {a}}_{i}^{(\eta )}{\hat {b}}_{j}^{(\eta )}x_{ij}$
Notes:
* The two variants of the algorithm are mathematically equivalent, as can be seen by formal induction. With factor estimation, it is not necessary to actually compute each cycle's ${\hat {m}}_{ij}^{(\eta )}$.
* The factorization is not unique, since it is $m_{ij}=a_{i}b_{j}x_{ij}=(\gamma a_{i})({\frac {1}{\gamma }}b_{j})x_{ij}$ for all $\gamma >0$.

## Discussion

The vaguely demanded 'similarity' between M and X can be explained as follows: IPFP (and thus RAS) maintains the crossproduct ratios, i.e.
    ${\frac {m_{ij}^{(\eta )}m_{hk}^{(\eta )}}{m_{ik}^{(\eta )}m_{hj}^{(\eta )}}}={\frac {x_{ij}x_{hk}}{x_{ik}x_{hj}}}\ \forall \ \eta \geq 0{\text{ and }}i\neq h,\quad j\neq k$
since $m_{ij}^{(\eta )}=a_{i}^{(\eta )}b_{j}^{(\eta )}x_{ij}.$
This property is sometimes called structure conservation and directly leads to the geometrical interpretation of contingency tables and the proof of convergence in the seminal paper of Fienberg (1970).
Direct factor estimation (algorithm 2) is generally the more efficient way to solve IPF: Whereas a form of the classical IPFP needs
    $IJ(2+J)+IJ(2+I)=I^{2}J+IJ^{2}+4IJ\,$
elementary operations in each iteration step (including a row and a column fitting step), factor estimation needs only
    $I(1+J)+J(1+I)=2IJ+I+J\,$
operations being at least one order in magnitude faster than classical IPFP.
IPFP can be used to estimate expected quasi-independent (incomplete) contingency tables, with $u_{i}=x_{i+},v_{j}=x_{+j}$, and $m_{ij}^{0}=1$ for included cells and $m_{ij}^{0}=0$ for excluded cells. For fully independent (complete) contingency tables, estimation with IPFP concludes exactly in one cycle.

### Comparison with the NM-method

Similar to the IPF, the NM-method is also an operation of finding a matrix $X$ which is the “closest” to matrix $Z$ ($Z\in \mathbb {N} ^{n\times m}$) while its row totals and column totals are identical to those of a target matrix $Y$ $(Y\in \mathbb {N} ^{n\times m})$.
However, there are differences between the NM-method and the IPF. For instance, the NM-method defines closeness of matrices of the same size differently from the IPF. Also, the NM-method was developed to solve for matrix $X$ in problems, where matrix ${\boldsymbol {Z}}$ is not a sample from the population characterized by the row totals and column totals of matrix $Y$, but represents another population. In contrast, matrix ${\boldsymbol {Z}}$ is a sample from this population in problems where the IPF is applied as the maximum likelihood estimator.
Macdonald (2023) is at ease with the conclusion by Naszodi (2023) that the IPF is suitable for sampling correction tasks, but not for generation of counterfactuals. Similarly to Naszodi, Macdonald also questions whether the row and column proportional transformations of the IPF preserve the structure of association within a contingency table that allows us to study social mobility.

## Existence and uniqueness of MLEs

Necessary and sufficient conditions for the existence and uniqueness of MLEs are complicated in the general case (see), but sufficient conditions for 2-dimensional tables are simple:
* the marginals of the observed table do not vanish (that is, $x_{i+}>0,\ x_{+j}>0$) and
* the observed table is inseparable (i.e. the table does not permute to a block-diagonal shape).
If unique MLEs exist, IPFP exhibits linear convergence in the worst case (Fienberg 1970), but exponential convergence has also been observed (Pukelsheim and Simeone 2009). If a direct estimator (i.e. a closed form of $({\hat {m}}_{ij})$) exists, IPFP converges after 2 iterations. If unique MLEs do not exist, IPFP converges toward the so-called extended MLEs by design (Haberman 1974), but convergence may be arbitrarily slow and often computationally infeasible.
If all observed values are strictly positive, existence and uniqueness of MLEs and therefore convergence is ensured.

## Example

Consider the following table, given with the row- and column-sums and targets.
| | 1 | 2 | 3 | 4 | TOTAL | TARGET |
| 1 | 40 | 30 | 20 | 10 | 100 | 150 |
| 2 | 35 | 50 | 100 | 75 | 260 | 300 |
| 3 | 30 | 80 | 70 | 120 | 300 | 400 |
| 4 | 20 | 30 | 40 | 50 | 140 | 150 |
| TOTAL | 125 | 190 | 230 | 255 | 800 | |
| TARGET | 200 | 300 | 400 | 100 | | 1000 |
For executing the classical IPFP, we first adjust the rows:
| | 1 | 2 | 3 | 4 | TOTAL | TARGET |
| 1 | 60.00 | 45.00 | 30.00 | 15.00 | 150.00 | 150 |
| 2 | 40.38 | 57.69 | 115.38 | 86.54 | 300.00 | 300 |
| 3 | 40.00 | 106.67 | 93.33 | 160.00 | 400.00 | 400 |
| 4 | 21.43 | 32.14 | 42.86 | 53.57 | 150.00 | 150 |
| TOTAL | 161.81 | 241.50 | 281.58 | 315.11 | 1000.00 | |
| TARGET | 200 | 300 | 400 | 100 | | 1000 |
The first step exactly matched row sums, but not the column sums. Next we adjust the columns:
| | 1 | 2 | 3 | 4 | TOTAL | TARGET |
| 1 | 74.16 | 55.90 | 42.62 | 4.76 | 177.44 | 150 |
| 2 | 49.92 | 71.67 | 163.91 | 27.46 | 312.96 | 300 |
| 3 | 49.44 | 132.50 | 132.59 | 50.78 | 365.31 | 400 |
| 4 | 26.49 | 39.93 | 60.88 | 17.00 | 144.30 | 150 |
| TOTAL | 200.00 | 300.00 | 400.00 | 100.00 | 1000.00 | |
| TARGET | 200 | 300 | 400 | 100 | | 1000 |
Now the column sums exactly match their targets, but the row sums no longer match theirs. After completing three cycles, each with a row adjustment and a column adjustment, we get a closer approximation:
| | 1 | 2 | 3 | 4 | TOTAL | TARGET |
| 1 | 64.61 | 46.28 | 35.42 | 3.83 | 150.13 | 150 |
| 2 | 49.95 | 68.15 | 156.49 | 25.37 | 299.96 | 300 |
| 3 | 56.70 | 144.40 | 145.06 | 53.76 | 399.92 | 400 |
| 4 | 28.74 | 41.18 | 63.03 | 17.03 | 149.99 | 150 |
| TOTAL | 200.00 | 300.00 | 400.00 | 100.00 | 1000.00 | |
| TARGET | 200 | 300 | 400 | 100 | | 1000 |

## Implementation

The R package mipfp (currently in version 3.2) provides a multi-dimensional implementation of the traditional iterative proportional fitting procedure. The package allows the updating of a N-dimensional array with respect to given target marginal distributions (which, in turn can be multi-dimensional).
Python has an equivalent package, ipfn that can be installed via pip. The package supports numpy and pandas input objects.