GAMS [ Home | Support | Sales | Solvers | Documentation | Model Library | Search | Contact Us ]

cta.gms : Controlled Tabular Adjustments


Statistical agencies publish data which contains items that need to be
altered to protect confidentiality. Controlled Tabular Adjustments (CTA)
is a recent method to limit disclosure and can be elegantly expressed
as a Mixed Integer Programming problem. The programming framework then
allows easy expression of other data relationships like multi-dimensional
adding up conditions. The following model uses a 3-dimensional table from
from Cox, Kelly and Patil (2005) to illustrate this method.

The data is stored in an Excel Spreadsheet.

Reference:
Large Model of Type: MIP    Includes:  cox3.xls
$title Controlled Tabular Adjustments (CTA,SEQ=310) $ontext Statistical agencies publish data which contains items that need to be altered to protect confidentiality. Controlled Tabular Adjustments (CTA) is a recent method to limit disclosure and can be elegantly expressed as a Mixed Integer Programming problem. The programming framework then allows easy expression of other data relationships like multi-dimensional adding up conditions. The following model uses a 3-dimensional table from from Cox, Kelly and Patil (2005) to illustrate this method. The data is stored in an Excel Spreadsheet. Lawrence H Cox, James P Kelly and Rahul J Patil, Computational Aspects of Controlled Tabular Adjustments: Algorithms and Analysis, in The Next Wave in Computing, Optimization, and Decision Technologies, Eds Bruce L Golden, S Raghavan and Edward A Wasil, Springer, 2005, pp 45-59. $offtext * extract data from Excel $if %system.filesys% == UNIX $terminate $onecho > temp.txt *extract domain information dset=i rng=sheet1!b2 rdim=1 dset=j rng=sheet1!c1 cdim=1 dset=k rng=sheet1!a2 rdim=1 *extract data par=dat rng=sheet1!a1 rdim=2 cdim=1 par=pro rng=sheet2!a1 rdim=2 cdim=1 $offecho $call =gdxxrw cox3.xls trace=0 @temp.txt $if errorlevel 1 $abort data extraction failed sets i rows,j columns, k planes; parameter dat(k,i,j) unprotected data table, pro(k,i,j) information sensitive cells ; $gdxin cox3 $load i j k dat pro $gdxin * do some basic data checks abort$sum((i,k), round(sum(j, dat(k,i,j)) - 2*dat(k,i,'total'))) 'row totals are incorrect',dat; abort$sum((j,k), round(sum(i, dat(k,i,j)) - 2*dat(k,'total',j))) 'column totals are incorrect',dat; abort$sum((i,j), round(sum(k, dat(k,i,j)) - 2*dat('total',i,j))) 'plane totals are incorrect',dat; variables t(i,j,k) adjusted cell value obj positive variables adjN(i,j,k),adjP(i,j,k); binary variable b(i,j,k); equations defadj(i,j,k) define new cell values addrow(i,k) add up for rows addcol(j,k) add up for columns addpla(i,j) add up for plane pmin(i,j,k) small value for sensitive cells pmax(i,j,k) big value for sensitive cells defobj; sets v(i,j,k) non zero cells s(i,j,k) sensitive cells; parameter BigM the famous big M - make it as small as possible; defadj(v(i,j,k)).. t(v) =e= dat(k,i,j) + adjP(v) - adjN(v); addrow(i,k).. sum(v(i,j,k), t(v)) =e= 2*t(i,'total',k); addcol(j,k).. sum(v(i,j,k), t(v)) =e= 2*t('total',j,k); addpla(i,j).. sum(v(i,j,k), t(v)) =e= 2*t(i,j,'total'); pmin(s(i,j,k)).. adjN(s) =g= pro(k,i,j)*(1-b(s)); pmax(s(i,j,k)).. adjP(s) =g= pro(k,i,j)*b(s); equations pminx,pmaxx; pminx(s(i,j,k)).. adjN(s) =l= BigM*pro(k,i,j)*(1-b(s)); pmaxx(s(i,j,k)).. adjP(s) =l= BigM*pro(k,i,j)*b(s); defobj.. obj =e= sum(v, adjN(v) + adjP(v)); model cox3 / all /; v(i,j,k) = dat(k,i,j); s(i,j,k) = pro(k,i,j); option limcol=0,limrow=0,solprint=off,optcr=0,optca=0.99,iterlim=1e8,reslim=10; BigM = 2; solve cox3 min obj us mip; parameter rep(k,i,j) summary report adjsum(k,i,j,*) adjustment summary adjrep(k,i,j) adjustment report; option rep:0:2:1,adjrep:0:2:1,adjsum:3:3:1; rep(k,i,j) = t.l(i,j,k); adjsum(k,i,j,'neg') = adjn.l(i,j,k); adjsum(k,i,j,'pos') = adjp.l(i,j,k); adjsum(k,i,j,'min') = pro(k,i,j); adjrep(k,i,j) = - adjN.l(i,j,k) + adjp.l(i,j,k); display adjrep,rep,adjsum; * now we find the next best 5 solutions set l solution labels / solution1*solution5 /, ll(l) dynamic version of l; parameters binrep(*,*,*,l) binary for protected variables best best objective value; option binrep:0:3:1; equation cutone(l),cuttwo(l) cuts to exclude previous solutions; * there is always a complementary solution by just changing all the signs * cut(ll).. sum(s, abs(b(s)-binrep(s,ll)) =g= 1; cutone(ll).. sum(s$binrep(s,ll), 1-b(s)) + sum(s$(not binrep(s,ll)), b(s)) =g= 1; cuttwo(ll).. sum(s$(not binrep(s,ll)), 1-b(s)) + sum(s$binrep(s,ll), b(s)) =g= 1; model cox3c includes cuts / all /; * find the card(l) best solutions that are within 1% of the global best=round(obj.l); cox3c.resusd = cox3.resusd; cox3c.nodusd = cox3.nodusd; loop(l$((obj.l - best)/best <= 0.01), ll(l) = yes; binrep(s,l) = round(b.l(s)); binrep('','','Obj',l) = obj.l; binrep('','','mSec',l) = cox3c.resusd*1000; binrep('','','nodes',l) = cox3c.nodusd; binrep('Comp','Cells','Adjusted',l) = sum((i,j,k)$(not s(i,j,k)), 1$round(adjn.l(i,j,k) + adjp.l(i,j,k))); solve cox3c min obj us mip ); display binrep;