function datatomfile (s, var_list, names)

% This command saves the simulation results in a text file. The name of each
% variable preceeds the corresponding results. This command must follow SIMUL
% or STOCH_SIMUL commands.
%
% INPUTS
%  - s:           [string]   data file name
%  - var_list:    [cell]     vector of selected endogenous variables
%  - names:       [cell]     vector of alternative names for the endogenous variables in the data file
%
% OUTPUTS
% none
%
% REMARKS
% Only the first argument is mandatory. If only one input argument is
% provided, all the variables as defined in M_.endo_names will be saved in
% the generated m file.

% Copyright © 2001-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/>.

global M_ oo_

if isempty(oo_.endo_simul)
    error('datatomfile: oo_.endo_simul is empty. Check why the simulation failed.')
end

%construct .m file name, depending on whether user already provided file
%ending
[~,~,s_ext] = fileparts(s);

if isempty(s_ext)
    sm=[s,'.m'];
else
    if ~strcmp(s_ext,'.m')
        error('You did not provide a .m file as name of the datafile.')
    else
        sm=s;
    end
end

% Open the data file.
fid=fopen(sm,'w') ;

if nargin < 2 || isempty(var_list)
    var_list = M_.endo_names(1:M_.orig_endo_nbr);
end

if ischar(var_list) %make robust against wrong input type
    var_list=cellstr(var_list);
end
if nargin==3
    if ischar(names) %make robust against wrong input type
        names = cellstr(names);
    end
    n = length(names);
    if ~isequal(length(var_list), n)
        error('datatomfile:: Second and third arguments must have the same number of rows (variables)!')
    end
else
    names = var_list;
    n = length(names);
end

ivar=zeros(n, 1);

% Get indices for the endogenous variables.
for i=1:n
    i_tmp = strmatch(var_list{i}, M_.endo_names, 'exact');
    if isempty(i_tmp)
        error ('One of the specified variables does not exist') ;
    else
        ivar(i) = i_tmp;
    end
end
fprintf(fid,'%% Dataset generated by %s.mod\n',M_.fname);
fprintf(fid,['%% ' datestr(now,0) '\n']);
% Save the selected data.
for i = 1:n
    fprintf(fid,[names{i}, ' = ['],'\n') ;
    fprintf(fid,'\n') ;
    fprintf(fid,'%15.8g\n',oo_.endo_simul(ivar(i),:)') ;
    fprintf(fid,'];\n') ;
    fprintf(fid,'\n') ;
end

% Close the data file.
fclose(fid) ;
