%SELECTIONF   Selection filter
%
% SYNOPSIS:
%  image_out = selectionf(image_in,control,filterSize,filterShape,threshold,mode,boundary_condition)
%  image_out = selectionf(image_in,control,neighborhood,threshold,mode,boundary_condition)
%
% PARAMETERS:
%  in:           image from which values are selected
%  control:      image in which the local minimum/maximum is found
%  filterSize:   sizes of the filter along each image dimension
%  filterShape:  'rectangular', 'elliptic', 'diamond'
%  neighborhood: binary image with the shape for the filtering kernel
%  threshold:    minimum difference in 'selection' to shift kernel
%  mode:         'minimum' or 'maximum'
%  boundary_condition: Defines how the boundary of the image is handled.
%                      See HELP BOUNDARY_CONDITION
%
%  The filter kernel can be specified in two ways: through FILTERSIZE
%  and FILTERSHAPE, specifying one of the default shapes, or through NEIGHBORHOOD,
%  providing a custom binary shape.
%
% DEFAULTS:
%  filterSize = 7
%  filterShape = 'elliptic'
%  threshold = 0
%  mode = 'minimum'
%  boundary_condition = 'mirror'
%
% DIPlib:
%  This function calls the DIPlib function dip::SelectionFilter.

% (c)2017, Cris Luengo.
% Based on original DIPlib code: (c)1995-2014, Delft University of Technology.
% Based on original DIPimage code: (c)1999-2014, Delft University of Technology.
%
% Licensed under the Apache License, Version 2.0 (the "License");
% you may not use this file except in compliance with the License.
% You may obtain a copy of the License at
%
%    http://www.apache.org/licenses/LICENSE-2.0
%
% Unless required by applicable law or agreed to in writing, software
% distributed under the License is distributed on an "AS IS" BASIS,
% WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
% See the License for the specific language governing permissions and
% limitations under the License.
