forked from visad/visad
-
Notifications
You must be signed in to change notification settings - Fork 0
/
Copy pathREADME
97 lines (79 loc) · 2.97 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
Repository Layout
=================
:core: Everything in the `visad.*` and `edu.ssec.wisc.mcidas.*` namespace.
:deps: Third party dependencies
:examples: VisAD examples with the default namespace (no java package).
::
|-- core
| |-- build
| |-- lib
| `-- src
| |-- edu/...
| `-- visad/...
|
|-- deps
| |-- build
| `-- src
| |-- HTTPClient/...
| |-- Jama/...
| |-- dods/...
| |-- gnu/...
| |-- loci/...
| |-- ncsa/...
| |-- nom/...
| `-- ucar/...
|
`-- examples
|-- build
|-- lib
`-- src
Building
========
There are 4 main build files (the old visad/build.xml has been removed).
The main build file `./build.xml` can be used to build the sub-projects
and create the main VisAD distribution files. Each sub-project also has
its own build file that can be used to perform basic build/clean/jar
operations for just that project.
You can use `ant -p` to display build script target descriptions
for each ant file for more information.
Building the Distribution
-------------------------
Run the following commands:
git clone https://github.com/visad/visad.git
cd visad
ant dist
Building the Core
----------------------
From your working copy you can simply run any of the commands listed by `ant -p`.
If you jar the core it will extract `lib/visaddeps.jar` and include the class files
in the generated visad.jar.
Building the Examples
---------------------
The examples project build file checks to see if VisAD is available as either a jar file
in the examples project lib directory or in ../core (assuming you checked out all of
visad). If it cannot find VisAD it attempts to call ../core/build.xml to build it before
compiling the examples. If you have VisAD in another location you can compile
the examples as follows:
ant -Dvisad.dir=<YOUR VISAD DIR> build
VisAD and Eclipse
=================
:Eclipse: http://www.eclipse.org
First, download and install Eclipse. These instructions assume you will be using
Eclipse >= v3.2. There are multiple flavors of Eclipse that can add varying
amounts of bloat. I recommend you keep it simple and stick to "Eclipse IDE for
Java Developers."
:Note: These instructions were written from a Mac, so you may have to adjust
slightly for your platform.
Create and Checkout Projects
----------------------------
* From the menubar select `File > Import...`.
* In the new dialog select `Git > Git Repository` and click `Next`.
* Copy `https://github.com/visad/visad.git` and paste into the `URI` field.
* (optional) Click `Next` and configure the details of the cloned repository.
* If you skipped the previous step, simply click `Finish`.
Building from Eclipse
---------------------
* From the menubar select `Window > Show View > Ant`.
* In the `Ant` view tab, right-click and select `Add Buildfiles`.
* Select the build file for each sub-project created above and click `OK`.
* In the `Ant` view tab, expand a project and select the build target to run.