techPref.m

function outPref = techPref(inPref)
%TECHPREF   Preference settings for TRIGTECH.
%   P = TRIGTECH.TECHPREF() returns a structure P with fields which contain the
%   default TRIGTECH preferences as field/value pairs.  This structure may be
%   passed to the TRIGTECH constructor.
%
%   P = TRIGTECH.TECHPREF(Q) does the same but replaces the default TRIGTECH
%   preferences with the values specified by the field/value pairs in the input
%   structure Q.
%
%   Note that no checking of either the input preference names or values takes
%   place and that preference names are case-sensitive.
%
%   ABSTRACT PREFERENCES REQUIRED OF ALL TECHS
%
%     chebfuneps   - Relative tolerance used in construction and subsequent
%      [2^-52]       operations.  See TRIGTECH.HAPPINESSCHECK for more details.
%
%     maxLength    - Maximum number of points used by the constructor.
%      [2^16+1]
%
%     fixedLength  - Fixed number of points used by constructor.  NaN allows
%      [NaN]         adaptive construction.
%
%     extrapolate
%       true       - Function values at endpoints may be extrapolated from
%                    interior values rather than sampled.
%      [false]     - Do not extrapolate values at endpoints.
%
%     sampleTest
%      [true]      - Tests the function at one more arbitrary point to
%                    minimize the risk of missing signals between grid
%                    points.
%       false      - Do not test.
%
%   TRIGTECH-SPECIFIC PREFERENCES
%
%     gridType     - Type of equi-spaced grid used to sample the function.
%         1        - Equally spaced grid starting at -1+h/2
%        [2]       - Equally spaced grid starting at -1
%
%     minSamples    - Minimum number of points used by the constructor.  Should
%      [17]          be of the form 2^n + 1.  If not, it is rounded as such.
%
%     refinementFunction - Define function for refining sample values.
%       'nested'         - Nest the evaluations to reduce the number of function evaluations.
%      ['resampling']    - Every function value is computed afresh as the
%                          constructor tries grids of size 9, 17, 33, etc.
%       function_handle  - A user-defined refinement function.  See REFINE.m
%
%     happinessCheck     - Define function for testing happiness.
%      ['standard']      - Standard check routine 
%       'classic'        - Use the default process from Chebfun v4.
%       'strict'         - Strict tolerance for coefficients.
%       'loose'          - A looser tolerance for coefficients.
%       function_handle  - A user defined happiness. See HAPPINESSCHECK.m
%
% See also TRIGTECH, CHEBTECH, CHEBTECH1, CHEBTECH2

% Copyright 2017 by The University of Oxford and The Chebfun Developers.
% See http://www.chebfun.org/ for Chebfun information.

outPref.chebfuneps         = 2^-52;
outPref.gridType           = 2;
outPref.minSamples         = 17;
outPref.maxLength          = 2^16;
outPref.fixedLength        = NaN;
outPref.extrapolate        = false;
outPref.sampleTest         = true;
outPref.refinementFunction = 'nested';
outPref.happinessCheck     = 'standard';

if ( nargin == 1 )
    validPrefs = fieldnames(outPref);
    for ( givenPref = fieldnames(inPref).');
        givenPref = givenPref{1};
        if ( ~any(strcmp(givenPref, validPrefs)) )
            warning('CHEBFUN:TRIGTECH:techPref:unknownPref', ...
                ['Unrecognized input preference ''' givenPref '''.']);
        end
    end

    outPref = chebfunpref.mergeTechPrefs(outPref, inPref);
end

end