annotate scripts/deprecated/glpkmex.m @ 12304:c16ce72e0a22 release-3-4-x

Deprecate glpkmex function and remove from documentation.
author Rik <octave@nomad.inbox5.com>
date Sun, 30 Jan 2011 07:52:36 -0800
parents scripts/optimization/glpkmex.m@39bf9ee145a8
children
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
11523
fd0a3ac60b0e update copyright notices
John W. Eaton <jwe@octave.org>
parents: 11471
diff changeset
1 ## Copyright (C) 2005-2011 Nicolo' Giorgetti
5237
652e8aa49fa7 [project @ 2005-03-23 21:28:45 by jwe]
jwe
parents:
diff changeset
2 ##
652e8aa49fa7 [project @ 2005-03-23 21:28:45 by jwe]
jwe
parents:
diff changeset
3 ## This file is part of Octave.
652e8aa49fa7 [project @ 2005-03-23 21:28:45 by jwe]
jwe
parents:
diff changeset
4 ##
652e8aa49fa7 [project @ 2005-03-23 21:28:45 by jwe]
jwe
parents:
diff changeset
5 ## Octave is free software; you can redistribute it and/or modify it
652e8aa49fa7 [project @ 2005-03-23 21:28:45 by jwe]
jwe
parents:
diff changeset
6 ## under the terms of the GNU General Public License as published by
7016
93c65f2a5668 [project @ 2007-10-12 06:40:56 by jwe]
jwe
parents: 6555
diff changeset
7 ## the Free Software Foundation; either version 3 of the License, or (at
93c65f2a5668 [project @ 2007-10-12 06:40:56 by jwe]
jwe
parents: 6555
diff changeset
8 ## your option) any later version.
5237
652e8aa49fa7 [project @ 2005-03-23 21:28:45 by jwe]
jwe
parents:
diff changeset
9 ##
652e8aa49fa7 [project @ 2005-03-23 21:28:45 by jwe]
jwe
parents:
diff changeset
10 ## Octave is distributed in the hope that it will be useful, but
652e8aa49fa7 [project @ 2005-03-23 21:28:45 by jwe]
jwe
parents:
diff changeset
11 ## WITHOUT ANY WARRANTY; without even the implied warranty of
652e8aa49fa7 [project @ 2005-03-23 21:28:45 by jwe]
jwe
parents:
diff changeset
12 ## MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
652e8aa49fa7 [project @ 2005-03-23 21:28:45 by jwe]
jwe
parents:
diff changeset
13 ## General Public License for more details.
652e8aa49fa7 [project @ 2005-03-23 21:28:45 by jwe]
jwe
parents:
diff changeset
14 ##
652e8aa49fa7 [project @ 2005-03-23 21:28:45 by jwe]
jwe
parents:
diff changeset
15 ## You should have received a copy of the GNU General Public License
7016
93c65f2a5668 [project @ 2007-10-12 06:40:56 by jwe]
jwe
parents: 6555
diff changeset
16 ## along with Octave; see the file COPYING. If not, see
93c65f2a5668 [project @ 2007-10-12 06:40:56 by jwe]
jwe
parents: 6555
diff changeset
17 ## <http://www.gnu.org/licenses/>.
5237
652e8aa49fa7 [project @ 2005-03-23 21:28:45 by jwe]
jwe
parents:
diff changeset
18
5244
a34c3c5c37cf [project @ 2005-03-25 03:29:52 by jwe]
jwe
parents: 5241
diff changeset
19 ## -*- texinfo -*-
11471
994e2a93a8e2 Use uppercase 'A' to refer to matrix inputs in m-files.
Rik <octave@nomad.inbox5.com>
parents: 10793
diff changeset
20 ## @deftypefn {Function File} {[@var{xopt}, @var{fmin}, @var{status}, @var{extra}] =} glpkmex (@var{sense}, @var{c}, @var{A}, @var{b}, @var{ctype}, @var{lb}, @var{ub}, @var{vartype}, @var{param}, @var{lpsolver}, @var{save_pb})
9051
1bf0ce0930be Grammar check TexInfo in all .m files
Rik <rdrider0-list@yahoo.com>
parents: 7017
diff changeset
21 ## This function is provided for compatibility with the old @sc{matlab}
10793
be55736a0783 Grammarcheck the documentation from m-files.
Rik <octave@nomad.inbox5.com>
parents: 9245
diff changeset
22 ## interface to the GNU @sc{glpk} library. For Octave code, you should use
5244
a34c3c5c37cf [project @ 2005-03-25 03:29:52 by jwe]
jwe
parents: 5241
diff changeset
23 ## the @code{glpk} function instead.
12289
39bf9ee145a8 Add glpkmex function to documentation.
Rik <octave@nomad.inbox5.com>
parents: 11523
diff changeset
24 ## @seealso{glpk}
5375
3522d923fb65 [project @ 2005-05-30 13:03:15 by dbateman]
dbateman
parents: 5307
diff changeset
25 ## @end deftypefn
5237
652e8aa49fa7 [project @ 2005-03-23 21:28:45 by jwe]
jwe
parents:
diff changeset
26
652e8aa49fa7 [project @ 2005-03-23 21:28:45 by jwe]
jwe
parents:
diff changeset
27 function [xopt, fopt, status, extra] = glpkmex (varargin)
652e8aa49fa7 [project @ 2005-03-23 21:28:45 by jwe]
jwe
parents:
diff changeset
28
12304
c16ce72e0a22 Deprecate glpkmex function and remove from documentation.
Rik <octave@nomad.inbox5.com>
parents: 12289
diff changeset
29 persistent warned = false;
c16ce72e0a22 Deprecate glpkmex function and remove from documentation.
Rik <octave@nomad.inbox5.com>
parents: 12289
diff changeset
30 if (! warned)
c16ce72e0a22 Deprecate glpkmex function and remove from documentation.
Rik <octave@nomad.inbox5.com>
parents: 12289
diff changeset
31 warned = true;
c16ce72e0a22 Deprecate glpkmex function and remove from documentation.
Rik <octave@nomad.inbox5.com>
parents: 12289
diff changeset
32 warning ("Octave:deprecated-function",
c16ce72e0a22 Deprecate glpkmex function and remove from documentation.
Rik <octave@nomad.inbox5.com>
parents: 12289
diff changeset
33 "glpkmex is obsolete and will be removed from a future version of Octave; please use glpk instead");
c16ce72e0a22 Deprecate glpkmex function and remove from documentation.
Rik <octave@nomad.inbox5.com>
parents: 12289
diff changeset
34 endif
c16ce72e0a22 Deprecate glpkmex function and remove from documentation.
Rik <octave@nomad.inbox5.com>
parents: 12289
diff changeset
35
5237
652e8aa49fa7 [project @ 2005-03-23 21:28:45 by jwe]
jwe
parents:
diff changeset
36 ## If there is no input output the version and syntax
652e8aa49fa7 [project @ 2005-03-23 21:28:45 by jwe]
jwe
parents:
diff changeset
37 if (nargin < 4 || nargin > 11)
6046
34f96dd5441b [project @ 2006-10-10 16:10:25 by jwe]
jwe
parents: 5375
diff changeset
38 print_usage ();
5237
652e8aa49fa7 [project @ 2005-03-23 21:28:45 by jwe]
jwe
parents:
diff changeset
39 return;
652e8aa49fa7 [project @ 2005-03-23 21:28:45 by jwe]
jwe
parents:
diff changeset
40 endif
652e8aa49fa7 [project @ 2005-03-23 21:28:45 by jwe]
jwe
parents:
diff changeset
41
652e8aa49fa7 [project @ 2005-03-23 21:28:45 by jwe]
jwe
parents:
diff changeset
42 ## reorder args:
652e8aa49fa7 [project @ 2005-03-23 21:28:45 by jwe]
jwe
parents:
diff changeset
43 ##
652e8aa49fa7 [project @ 2005-03-23 21:28:45 by jwe]
jwe
parents:
diff changeset
44 ## glpkmex glpk
652e8aa49fa7 [project @ 2005-03-23 21:28:45 by jwe]
jwe
parents:
diff changeset
45 ##
652e8aa49fa7 [project @ 2005-03-23 21:28:45 by jwe]
jwe
parents:
diff changeset
46 ## 1 sense c
652e8aa49fa7 [project @ 2005-03-23 21:28:45 by jwe]
jwe
parents:
diff changeset
47 ## 2 c a
652e8aa49fa7 [project @ 2005-03-23 21:28:45 by jwe]
jwe
parents:
diff changeset
48 ## 3 a b
652e8aa49fa7 [project @ 2005-03-23 21:28:45 by jwe]
jwe
parents:
diff changeset
49 ## 4 b lb
652e8aa49fa7 [project @ 2005-03-23 21:28:45 by jwe]
jwe
parents:
diff changeset
50 ## 5 ctype ub
652e8aa49fa7 [project @ 2005-03-23 21:28:45 by jwe]
jwe
parents:
diff changeset
51 ## 6 lb ctype
652e8aa49fa7 [project @ 2005-03-23 21:28:45 by jwe]
jwe
parents:
diff changeset
52 ## 7 ub vartype
652e8aa49fa7 [project @ 2005-03-23 21:28:45 by jwe]
jwe
parents:
diff changeset
53 ## 8 vartype sense
652e8aa49fa7 [project @ 2005-03-23 21:28:45 by jwe]
jwe
parents:
diff changeset
54 ## 9 param param
652e8aa49fa7 [project @ 2005-03-23 21:28:45 by jwe]
jwe
parents:
diff changeset
55 ## 10 lpsolver
652e8aa49fa7 [project @ 2005-03-23 21:28:45 by jwe]
jwe
parents:
diff changeset
56 ## 11 savepb
652e8aa49fa7 [project @ 2005-03-23 21:28:45 by jwe]
jwe
parents:
diff changeset
57
652e8aa49fa7 [project @ 2005-03-23 21:28:45 by jwe]
jwe
parents:
diff changeset
58 sense = varargin{1};
652e8aa49fa7 [project @ 2005-03-23 21:28:45 by jwe]
jwe
parents:
diff changeset
59 c = varargin{2};
652e8aa49fa7 [project @ 2005-03-23 21:28:45 by jwe]
jwe
parents:
diff changeset
60 a = varargin{3};
652e8aa49fa7 [project @ 2005-03-23 21:28:45 by jwe]
jwe
parents:
diff changeset
61 b = varargin{4};
652e8aa49fa7 [project @ 2005-03-23 21:28:45 by jwe]
jwe
parents:
diff changeset
62
652e8aa49fa7 [project @ 2005-03-23 21:28:45 by jwe]
jwe
parents:
diff changeset
63 nx = length (c);
652e8aa49fa7 [project @ 2005-03-23 21:28:45 by jwe]
jwe
parents:
diff changeset
64
652e8aa49fa7 [project @ 2005-03-23 21:28:45 by jwe]
jwe
parents:
diff changeset
65 if (nargin > 4)
652e8aa49fa7 [project @ 2005-03-23 21:28:45 by jwe]
jwe
parents:
diff changeset
66 ctype = varargin{5};
652e8aa49fa7 [project @ 2005-03-23 21:28:45 by jwe]
jwe
parents:
diff changeset
67 else
652e8aa49fa7 [project @ 2005-03-23 21:28:45 by jwe]
jwe
parents:
diff changeset
68 ctype = repmat ("U", nx, 1);
652e8aa49fa7 [project @ 2005-03-23 21:28:45 by jwe]
jwe
parents:
diff changeset
69 endif
652e8aa49fa7 [project @ 2005-03-23 21:28:45 by jwe]
jwe
parents:
diff changeset
70
652e8aa49fa7 [project @ 2005-03-23 21:28:45 by jwe]
jwe
parents:
diff changeset
71 if (nargin > 5)
652e8aa49fa7 [project @ 2005-03-23 21:28:45 by jwe]
jwe
parents:
diff changeset
72 lb = varargin{6};
652e8aa49fa7 [project @ 2005-03-23 21:28:45 by jwe]
jwe
parents:
diff changeset
73 else
652e8aa49fa7 [project @ 2005-03-23 21:28:45 by jwe]
jwe
parents:
diff changeset
74 lb = repmat (-Inf, nx, 1);
652e8aa49fa7 [project @ 2005-03-23 21:28:45 by jwe]
jwe
parents:
diff changeset
75 endif
652e8aa49fa7 [project @ 2005-03-23 21:28:45 by jwe]
jwe
parents:
diff changeset
76
652e8aa49fa7 [project @ 2005-03-23 21:28:45 by jwe]
jwe
parents:
diff changeset
77 if (nargin > 6)
652e8aa49fa7 [project @ 2005-03-23 21:28:45 by jwe]
jwe
parents:
diff changeset
78 ub = varargin{7};
652e8aa49fa7 [project @ 2005-03-23 21:28:45 by jwe]
jwe
parents:
diff changeset
79 else
652e8aa49fa7 [project @ 2005-03-23 21:28:45 by jwe]
jwe
parents:
diff changeset
80 ub = repmat (Inf, nx, 1);
652e8aa49fa7 [project @ 2005-03-23 21:28:45 by jwe]
jwe
parents:
diff changeset
81 endif
652e8aa49fa7 [project @ 2005-03-23 21:28:45 by jwe]
jwe
parents:
diff changeset
82
652e8aa49fa7 [project @ 2005-03-23 21:28:45 by jwe]
jwe
parents:
diff changeset
83 if (nargin > 7)
652e8aa49fa7 [project @ 2005-03-23 21:28:45 by jwe]
jwe
parents:
diff changeset
84 vartype = varargin{8};
652e8aa49fa7 [project @ 2005-03-23 21:28:45 by jwe]
jwe
parents:
diff changeset
85 else
652e8aa49fa7 [project @ 2005-03-23 21:28:45 by jwe]
jwe
parents:
diff changeset
86 vartype = repmat ("C", nx, 1);
652e8aa49fa7 [project @ 2005-03-23 21:28:45 by jwe]
jwe
parents:
diff changeset
87 endif
652e8aa49fa7 [project @ 2005-03-23 21:28:45 by jwe]
jwe
parents:
diff changeset
88
652e8aa49fa7 [project @ 2005-03-23 21:28:45 by jwe]
jwe
parents:
diff changeset
89 if (nargin > 8)
652e8aa49fa7 [project @ 2005-03-23 21:28:45 by jwe]
jwe
parents:
diff changeset
90 param = varargin{9};
652e8aa49fa7 [project @ 2005-03-23 21:28:45 by jwe]
jwe
parents:
diff changeset
91 else
652e8aa49fa7 [project @ 2005-03-23 21:28:45 by jwe]
jwe
parents:
diff changeset
92 param = struct ();
652e8aa49fa7 [project @ 2005-03-23 21:28:45 by jwe]
jwe
parents:
diff changeset
93 endif
652e8aa49fa7 [project @ 2005-03-23 21:28:45 by jwe]
jwe
parents:
diff changeset
94
652e8aa49fa7 [project @ 2005-03-23 21:28:45 by jwe]
jwe
parents:
diff changeset
95 if (nargin > 9 && ! isfield (param, "lpsolver"))
652e8aa49fa7 [project @ 2005-03-23 21:28:45 by jwe]
jwe
parents:
diff changeset
96 param.lpsolver = varargin{10};
652e8aa49fa7 [project @ 2005-03-23 21:28:45 by jwe]
jwe
parents:
diff changeset
97 endif
652e8aa49fa7 [project @ 2005-03-23 21:28:45 by jwe]
jwe
parents:
diff changeset
98
652e8aa49fa7 [project @ 2005-03-23 21:28:45 by jwe]
jwe
parents:
diff changeset
99 if (nargin > 10 && ! isfield (param, "save"))
5241
ab89f95de831 [project @ 2005-03-24 02:45:30 by jwe]
jwe
parents: 5237
diff changeset
100 param.save = varargin{11};
5237
652e8aa49fa7 [project @ 2005-03-23 21:28:45 by jwe]
jwe
parents:
diff changeset
101 endif
652e8aa49fa7 [project @ 2005-03-23 21:28:45 by jwe]
jwe
parents:
diff changeset
102
652e8aa49fa7 [project @ 2005-03-23 21:28:45 by jwe]
jwe
parents:
diff changeset
103 if (nargout == 0)
652e8aa49fa7 [project @ 2005-03-23 21:28:45 by jwe]
jwe
parents:
diff changeset
104 glpk (c, a, b, lb, ub, ctype, vartype, sense, param);
652e8aa49fa7 [project @ 2005-03-23 21:28:45 by jwe]
jwe
parents:
diff changeset
105 elseif (nargout == 1)
652e8aa49fa7 [project @ 2005-03-23 21:28:45 by jwe]
jwe
parents:
diff changeset
106 xopt = glpk (c, a, b, lb, ub, ctype, vartype, sense, param);
652e8aa49fa7 [project @ 2005-03-23 21:28:45 by jwe]
jwe
parents:
diff changeset
107 elseif (nargout == 2)
652e8aa49fa7 [project @ 2005-03-23 21:28:45 by jwe]
jwe
parents:
diff changeset
108 [xopt, fopt] = glpk (c, a, b, lb, ub, ctype, vartype, sense, param);
652e8aa49fa7 [project @ 2005-03-23 21:28:45 by jwe]
jwe
parents:
diff changeset
109 elseif (nargout == 3)
652e8aa49fa7 [project @ 2005-03-23 21:28:45 by jwe]
jwe
parents:
diff changeset
110 [xopt, fopt, status] = ...
652e8aa49fa7 [project @ 2005-03-23 21:28:45 by jwe]
jwe
parents:
diff changeset
111 glpk (c, a, b, lb, ub, ctype, vartype, sense, param);
652e8aa49fa7 [project @ 2005-03-23 21:28:45 by jwe]
jwe
parents:
diff changeset
112 else
652e8aa49fa7 [project @ 2005-03-23 21:28:45 by jwe]
jwe
parents:
diff changeset
113 [xopt, fopt, status, extra] = ...
652e8aa49fa7 [project @ 2005-03-23 21:28:45 by jwe]
jwe
parents:
diff changeset
114 glpk (c, a, b, lb, ub, ctype, vartype, sense, param);
652e8aa49fa7 [project @ 2005-03-23 21:28:45 by jwe]
jwe
parents:
diff changeset
115 endif
652e8aa49fa7 [project @ 2005-03-23 21:28:45 by jwe]
jwe
parents:
diff changeset
116
652e8aa49fa7 [project @ 2005-03-23 21:28:45 by jwe]
jwe
parents:
diff changeset
117 endfunction