function Simulations = extended_path_mc(initialconditions, samplesize, replic, exogenousvariables, options_, M_, oo_)
% Simulations = extended_path_mc(initialconditions, samplesize, replic, exogenousvariables, options_, M_, oo_)
% Conducts Monte Carlo replications of stochastic simulation of a non-linear DSGE model using the Extended Path method
%
% INPUTS
%  o initialconditions      [double]    m*1 array, where m is the number of endogenous variables in the model.
%  o samplesize             [integer]   scalar, size of the sample to be simulated.
%  o replic                 [integer]   number of replications
%  o exogenousvariables     [double]    T*n array, values for the structural innovations.
%  o options_               [struct]    Dynare's options structure
%  o M_                     [struct]    Dynare's model structure
%  o oo_                    [struct]    Dynare's results structure
%
% OUTPUTS
%  o Simulations            [struct]    simulation output
%
% ALGORITHM
%
% SPECIAL REQUIREMENTS

% Copyright © 2016-2026 Dynare Team
%
% This file is part of Dynare.
%
% Dynare 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.
%
% Dynare 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 Dynare.  If not, see <https://www.gnu.org/licenses/>.

[initialconditions, pfm, options_, oo_] = ...
    extended_path_initialization(initialconditions, options_, M_, oo_);

% Check the dimension of the first input argument
if isequal(size(initialconditions, 2), 1)
    initialconditions = repmat(initialconditions, 1, replic);
else
    if ~isequal(size(initialconditions, 2), replic)
        error('extended_path_mc: Wrong size. Number of columns in first argument should match the value of the third argument!')
    end
end

% Check the dimension of the fourth input argument
if isempty(exogenousvariables)
    exogenousvariables = repmat(exogenousvariables, [1, 1, replic]);
else
    if ~isequal(size(exogenousvariables, 3), replic)
        error('Wrong size. !')
    end
end
if ~isequal(size(exogenousvariables, 3), replic)
    error('extended_path_mc: Wrong dimensions. Fourth argument must be a 3D array with as many pages as the value of the third argument!')
end

data = NaN(size(initialconditions, 1), samplesize+1, replic);
vexo = NaN(pfm.effective_number_of_shocks, samplesize+1, replic);
info = NaN(replic, 1);

if options_.ep.parallel
    % Use the Parallel toolbox.
    initialconditions_parfor=initialconditions(:,1);
    parfor i=1:replic
        oo__ = oo_;
        [shocks, spfm_exo_simul, oo__] = extended_path_shocks(pfm, exogenousvariables(:,:,i), samplesize, M_, options_, oo__);
        endogenous_variables_paths = NaN(M_.endo_nbr,samplesize+1);
        endogenous_variables_paths(:,1) = initialconditions_parfor;
        exogenous_variables_paths = NaN(pfm.effective_number_of_shocks,samplesize+1);
        exogenous_variables_paths(:,1) = 0;
        info_convergence = true;
        t = 1;
        endogenousvariablespaths=[]; %initialize to suppress parfor warning
        while t<=samplesize
            t = t+1;
            spfm_exo_simul(2,:) = shocks(t-1,:);
            exogenous_variables_paths(:,t) = shocks(t-1,:);
            if t>2
                % Set initial guess for the solver (using the solution of the
                % previous period problem).
                initialguess = [endogenousvariablespaths(:, 2:end), oo_.steady_state];
            else
                initialguess = [];
            end
            [endogenous_variables_paths(:,t), info_convergence, endogenousvariablespaths] = ...
                extended_path_core(spfm_exo_simul, ...
                endogenous_variables_paths(:,t-1), ...
                pfm, ...
                M_, ...
                options_, ...
                oo__, ...
                initialguess);
            if ~info_convergence
                warning('extended_path_mc: No convergence of the (stochastic) perfect foresight solver (in period %s, iteration %s)!', int2str(t), int2str(i))
                break
            end
        end % Loop over t
        info(i) = info_convergence;
        vexo(:,:,i) = exogenous_variables_paths;
        data(:,:,i) = endogenous_variables_paths;
    end
else
    % Sequential approach.
    for i=1:replic
        [shocks, spfm_exo_simul, oo_] = extended_path_shocks(pfm, exogenousvariables(:,:,i), samplesize, M_, options_, oo_);
        endogenous_variables_paths = NaN(M_.endo_nbr,samplesize+1);
        endogenous_variables_paths(:,1) = initialconditions(:,1);
        exogenous_variables_paths = NaN(pfm.effective_number_of_shocks,samplesize+1);
        exogenous_variables_paths(:,1) = 0;
        t = 1;
        while t<=samplesize
            t = t+1;
            spfm_exo_simul(2,:) = shocks(t-1,:);
            exogenous_variables_paths(:,t) = shocks(t-1,:);
            if t>2
                % Set initial guess for the solver (using the solution of the
                % previous period problem).
                initialguess = [endogenousvariablespaths(:, 2:end), oo_.steady_state];
            else
                initialguess = [];
            end
            [endogenous_variables_paths(:,t), info_convergence, endogenousvariablespaths] = ...
                extended_path_core(spfm_exo_simul, ...
                endogenous_variables_paths(:,t-1), ...
                pfm, ...
                M_, ...
                options_, ...
                oo_, ...
                initialguess);
            if ~info_convergence
                warning('extended_path_mc: No convergence of the (stochastic) perfect foresight solver (in period %s, iteration %s)!', int2str(t), int2str(i))
                break
            end
        end % Loop over t
        info(i) = info_convergence;
        vexo(:,:,i) = exogenous_variables_paths;
        data(:,:,i) = endogenous_variables_paths;
    end % Loop over i
end

Simulations.innovations = vexo;
Simulations.data = data;
Simulations.info = info;
