function dec = addConfinementMappingData(dec)
% add data for confinement mapping
%
% The unified partitions already stored which boundaries might have been
%   violated by vectors inside of the confinement cone. We simply collect
%   this information. The corresponding boundaries will not be used for
%   "fading out" the growth rate when a hE-vector approaches that boundary.
%
% THIS IS NO USER FUNCTION

% The elk-library: convex geometry applied to crystallization modeling.
%   Copyright (C) 2013 Alexander Reinhold
%
% This program is free software: you can redistribute it and/or modify it 
%   under the terms of the GNU General Public License as published by the 
%   Free Software Foundation, either version 3 of the License, or (at your 
%   option) any later version.
%
% This program is distributed in the hope that it will be useful, but 
%   WITHOUT ANY WARRANTY; without even the implied warranty of 
%   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU 
%   General Public License for more details.
%
% You should have received a copy of the GNU General Public License along 
%   with this program.  If not, see <http://www.gnu.org/licenses/>.

%! DEV: This should be deprecated by now. It does not hurt to add it. But
%       it is not used anymore.
% ..and should not be used:
% dec.properData.confinementMappingData.ignoreFadeOut = false(1, ...
%     size(dec.properData.confinementMappingData.A, 1));
% 
% for iPart = 1:length(dec.unifiedPartition)
%     dec.properData.confinementMappingData.ignoreFadeOut(...
%         dec.unifiedPartition{iPart...
%         }.embedding.violatedConstraintIndexVector) = true;
% end
% dec.properData.confinementMappingData.ignoreFadeOut = find(...
%     dec.properData.confinementMappingData.ignoreFadeOut);
%/