Kurzanleitung JAMS-Entwicklung

Aus ILMS-Wiki
(Unterschied zwischen Versionen)
Wechseln zu: Navigation, Suche
Zeile 27: Zeile 27:
 
4. Import beenden
 
4. Import beenden
  
5. rechte Mousetaste auf Libraries -> Add JAR/Folder und hier '''alles''' aus c:\jams\JAMS\libs hinzufügen
+
5. rechte Mousetaste auf Libraries -> Add JAR/Folder und hier jscience.jar und JTS-x.x.jar aus c:\jams\JAMS\libs hinzufügen
  
 
6. rechte Mousetaste auf JAMS -> Clean and Build Project (Projekt compilieren und JAMS.jar in c:\jamsprojects\JAMS\dist\ erzeugen)
 
6. rechte Mousetaste auf JAMS -> Clean and Build Project (Projekt compilieren und JAMS.jar in c:\jamsprojects\JAMS\dist\ erzeugen)
 +
 +
====JAMSComponents====
 +
1. File -> New Projekt -> Java Project with Existing Sources
 +
 +
2. Projektname (z.B. JAMSComponents) und Verzeichnis (z.B. c:\jamsprojects\JAMSComponents) vergeben (hier landen die compilierten Klassen und das JAR-File) -> Next
 +
 +
3. Source Package Folder -> Add Folder -> c:\jams\JAMSComponents\src -> OK
 +
 +
4. Import beenden
 +
 +
5. rechte Mousetaste auf Libraries -> Add JAR/Folder und hier '''alles''' aus c:\jams\JAMS\libs hinzufügen
 +
 +
6. rechte Mousetaste auf JAMS -> Clean and Build Project (Projekt compilieren und JAMSComponents.jar in c:\jamsprojects\JAMSComponents\dist\ erzeugen)
  
 
====J2K====
 
====J2K====
Zeile 60: Zeile 73:
 
JAMS benötigt für die Ausführung eine [[Systemkonfiguration|Systemkonfigurationsdatei]] (z.B. "c:\jamsmodels\example.jap"), eine [[Modellkonfiguration|Modellkonfigurationsdatei]] (z.B. "c:\modeldata\JAMS-Gehlberg\j2k_gehlberg.jmc") und eine [[Modelldefinition|Modelldefinitionsdatei]] (z.B. "c:\modeldata\JAMS-Gehlberg\j2k_gehlberg.jmd"). Detailinformationen über die Konfiguration des Systems mit diesen drei Dateien sind [[Allgemeine_Systemkonfiguration|hier]] zu finden. Für die  JAMS-Ausführung wird dann wie folgt vorgegangen:
 
JAMS benötigt für die Ausführung eine [[Systemkonfiguration|Systemkonfigurationsdatei]] (z.B. "c:\jamsmodels\example.jap"), eine [[Modellkonfiguration|Modellkonfigurationsdatei]] (z.B. "c:\modeldata\JAMS-Gehlberg\j2k_gehlberg.jmc") und eine [[Modelldefinition|Modelldefinitionsdatei]] (z.B. "c:\modeldata\JAMS-Gehlberg\j2k_gehlberg.jmd"). Detailinformationen über die Konfiguration des Systems mit diesen drei Dateien sind [[Allgemeine_Systemkonfiguration|hier]] zu finden. Für die  JAMS-Ausführung wird dann wie folgt vorgegangen:
  
1. Pfadangaben in der Konfigurations- und Modelldefinitionsdatei anpassen
+
1. rechte Mousetaste auf JAMS -> Properties -> Run und
 
+
2. rechte Mousetaste auf JAMS -> Properties -> Run und
+
  
 
*"Main Class" auf org.unijena.jams.JAMS setzen
 
*"Main Class" auf org.unijena.jams.JAMS setzen
  
*Unter "Arguments" die vollständigen Pfade einer Konfigurationsdatei  und einer Modelldefinitionsdatei  (in dieser Reihenfolge) angegeben.
+
*Unter "Arguments" die vollständigen Pfade einer Konfigurationsdatei  und einer Modelldefinitionsdatei  (in dieser Reihenfolge) angegeben. Die Modelldefinitionsdatei ist hierbei optional und kann auch über die grafische Oberfläche des JAMS-Launchers ausgewählt werden.
 +
 
 +
2. rechte Mousetaste auf JAMS -> Clean and Build Project (Projekt compilieren und JAR erzeugen)
  
3. rechte Mousetaste auf JAMS -> Clean and Build Project (Projekt compilieren und JARs erzeugen)
+
3. rechte Mousetaste auf JAMSComponents -> Clean and Build Project (Projekt compilieren und JAR erzeugen)
  
4. rechte Mousetaste auf J2K -> Clean and Build Project (Projekt compilieren und JARs erzeugen)
+
4. rechte Mousetaste auf J2K -> Clean and Build Project (Projekt compilieren und JAR erzeugen)
  
 
5. rechte Mousetaste auf JAMS -> Run Project
 
5. rechte Mousetaste auf JAMS -> Run Project

Version vom 22. September 2006, 12:09 Uhr

Inhaltsverzeichnis

Installation der benötigter Software

1. Tortoise SVN (http://tortoisesvn.tigris.org/)

2. NetBeans/JDK5.0 (http://java.sun.com/j2se/1.5.0/download.jsp)

Einrichten der SVN-Repositories

1. Verzeichnis für JAMS-Core anlegen (z.B. c:\jams)

2. Verzeichnis für Modelle anlegen (z.B. c:\jamsmodels)

3. Verzeichnis für Daten anlegen (z.B. c:\modeldata)

4. rechte Mousetaste auf c:\jams -> SVN Checkout und svn://spree.geogr.uni-jena.de/jams/devel als URL des Repository’s angeben -> OK

5. rechte Mousetaste auf c:\jamsmodels -> SVN Checkout und svn://spree.geogr.uni-jena.de/jamsmodels/devel als URL des Repositorys angeben -> OK

6. rechte Mousetaste auf c:\modeldata -> SVN Checkout und svn://spree.geogr.uni-jena.de/modeldata als URL des Repositorys angeben -> OK

NetBeans-Projekte aufsetzen

JAMS

1. File -> New Projekt -> Java Project with Existing Sources

2. Projektname (z.B. JAMS) und Verzeichnis (z.B. c:\jamsprojects\JAMS) vergeben (hier landen die compilierten Klassen und das JAR-File) -> Next

3. Source Package Folder -> Add Folder -> c:\jams\JAMS\src -> OK

4. Import beenden

5. rechte Mousetaste auf Libraries -> Add JAR/Folder und hier jscience.jar und JTS-x.x.jar aus c:\jams\JAMS\libs hinzufügen

6. rechte Mousetaste auf JAMS -> Clean and Build Project (Projekt compilieren und JAMS.jar in c:\jamsprojects\JAMS\dist\ erzeugen)

JAMSComponents

1. File -> New Projekt -> Java Project with Existing Sources

2. Projektname (z.B. JAMSComponents) und Verzeichnis (z.B. c:\jamsprojects\JAMSComponents) vergeben (hier landen die compilierten Klassen und das JAR-File) -> Next

3. Source Package Folder -> Add Folder -> c:\jams\JAMSComponents\src -> OK

4. Import beenden

5. rechte Mousetaste auf Libraries -> Add JAR/Folder und hier alles aus c:\jams\JAMS\libs hinzufügen

6. rechte Mousetaste auf JAMS -> Clean and Build Project (Projekt compilieren und JAMSComponents.jar in c:\jamsprojects\JAMSComponents\dist\ erzeugen)

J2K

1. File -> New Projekt -> Java Project with Existing Sources

2. Projektname (z.B. J2K) und Verzeichnis (z.B. c:\jamsprojects\J2K) vergeben (hier landen die compilierten Klassen und das JAR-File) -> Next

3. Source Package Folder -> Add Folder -> c:\jamsmodels\J2K\src -> OK

4. Import beenden

5. rechte Mousetaste auf Libraries -> Add JAR/Folder und hier JAMS.jar aus c:\jamsprojects\JAMS\dist hinzufügen

Template für JAMS-Komponenten

Bitte verwendet in NetBeans dieses Template, welches ihr folgendermaßen einbinden könnt:

1. Tools -> Template Manager -> Java Classes

2. rechte Mousetaste auf Java Class -> Copy

3. rechte Mousetaste auf Java Classes -> Paste -> Copy

4. Class_1.java auswählen und "Open in Editor", in die geöffnete Datei den Template-Code einfügen (den alten löschen), abspeichern und schließen

5. rechte Mousetaste auf Class_1.java -> Rename und z.B. nach "JAMSComponent" umbenennen

Danach kann beim Anlegen einer neuen Klasse "JAMSComponent" als File Type ausgewählt werden.

JAMS/J2K ausführen

JAMS benötigt für die Ausführung eine Systemkonfigurationsdatei (z.B. "c:\jamsmodels\example.jap"), eine Modellkonfigurationsdatei (z.B. "c:\modeldata\JAMS-Gehlberg\j2k_gehlberg.jmc") und eine Modelldefinitionsdatei (z.B. "c:\modeldata\JAMS-Gehlberg\j2k_gehlberg.jmd"). Detailinformationen über die Konfiguration des Systems mit diesen drei Dateien sind hier zu finden. Für die JAMS-Ausführung wird dann wie folgt vorgegangen:

1. rechte Mousetaste auf JAMS -> Properties -> Run und

  • "Main Class" auf org.unijena.jams.JAMS setzen
  • Unter "Arguments" die vollständigen Pfade einer Konfigurationsdatei und einer Modelldefinitionsdatei (in dieser Reihenfolge) angegeben. Die Modelldefinitionsdatei ist hierbei optional und kann auch über die grafische Oberfläche des JAMS-Launchers ausgewählt werden.

2. rechte Mousetaste auf JAMS -> Clean and Build Project (Projekt compilieren und JAR erzeugen)

3. rechte Mousetaste auf JAMSComponents -> Clean and Build Project (Projekt compilieren und JAR erzeugen)

4. rechte Mousetaste auf J2K -> Clean and Build Project (Projekt compilieren und JAR erzeugen)

5. rechte Mousetaste auf JAMS -> Run Project

6. sich freuen, falls nichts abstürzt :)

Hinweis: Nach Modifikationen an Modellkomponenten muss vor der Ausführung immer erst das JAR-File mit den Komponenten neu erzeugt werden (Schritt 3)!

Meine Werkzeuge