forked from andern/pplex
-
Notifications
You must be signed in to change notification settings - Fork 0
/
Copy pathREADME
111 lines (78 loc) · 3.05 KB
/
README
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
pplex readme
Last updated: 2012-11-22
Release version: 0.4.1
------------------------------------------------------------------------
Table of contents
-----------------
1.0) About
2.0) Contacting
* 2.1 Reporting Bugs
3.0) Installing pplex
* 3.1 Running pplex
4.0) Compiling pplex
* 4.1 Applet
5.0) Documentation
1.0) About
---- -----
pplex is an application that can interpret linear programs (LP) and show
how the LP dictionary evolves throughout the execution of the simplex method.
pplex 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.
pplex uses Apache Commons Math library for handling matrices. It is released
under the Apache License, Version 2.0. See lib/LICENSE.TXT for more information.
2.0) Contacting
---- ----------
The pplex homepage is http://andern.github.com/pplex
2.1) Reporting Bugs
---- --------------
GitHub's issue tracker is used for tracking bugs of pplex. Before submitting a
bug you should make sure that you are running the latest version of pplex, and
that the bug has not already been submitted to the tracker on GitHub.
3.0) Installing pplex
---- ----------------
If you want to try pplex before installing it, you can try it as an applet by
visiting http://pplex.ii.uib.no. It has most of the functionality
of pplex (but you cannot read your own files.)
Running pplex requires Java Runtime Environment installed on your computer.
1. Download the newest version of pplex from
http://folk.uib.no/xif001/pplex/pplex.jar and put it anywhere you like.
2. Double-click on pplex.jar.
(Optional) Getting started:
3. Download test.lps from http://folk.uib.no/xif001/pplex/test.lps and
put it in the same directory as pplex.jar.
4. Type 'read test.lps' in pplex' console.
3.1) Running pplex
---- -------------
pplex starts in visual mode by default. This is only relevant for linear
programs with two variables. pplex can easily be run without a graphical
interface in a terminal window by passing the '-nogui' argument like this:
`java -jar pplex.jar -nogui`
4.0) Compiling pplex
---- ---------------
Compiling pplex requires:
* Java Development Kit
* Apache Ant
To compile pplex you first need to download the source code of pplex. This
can be done from the website (see 2.0) or by cloning the repository.
To clone the repository you need git installed on your system. Cloning
the repository is done by typing the following in a terminal:
`git clone git@github.com:andern/pplex.git`
To only compile the sources of pplex, run
`ant compile`
in the pplex directory.
To compile the sources of pplex and build a runnable jar, run
`ant jar`
or simply
`ant`
4.1) Applet
---- ------
pplex can be compiled as an applet by running
`ant applet`
in the pplex directory.
See applet.html in the pplex directory for an example
on how to deploy the applet on your own website.
5.0) Documentation
---- -------------
Documentation on how to use pplex can be found in doc/pplex_intro.pdf