Notice: this Wiki will be going read only early in 2024 and edits will no longer be possible. Please see: https://gitlab.eclipse.org/eclipsefdn/helpdesk/-/wikis/Wiki-shutdown-plan for the plan.
Difference between revisions of "AMP/UserGuide/Escape/Getting Started"
(→Developing Models) |
(→Developing Models) |
||
| Line 20: | Line 20: | ||
Then just create new Java classes for your root model scape and agents just as you would for an Ascape project. | Then just create new Java classes for your root model scape and agents just as you would for an Ascape project. | ||
| − | == | + | ==[http://wiki.eclipse.org/AMP/UserGuide/Escape/Converting_From_Ascape | Converting Existing AscapeModels]== |
Revision as of 17:47, 4 October 2009
Contents
Getting Started with Escape
Installation
Escape is installed by default with the other model components. If you want to do 3D (really 2 1/2) visualizations, you will want AGF3D and the LWJGL dependency. You can build from source but in that case you'l need to launch a self-hosted runtime, so it's best to simply install from the update site if you're not actually doing AMP development.
Running Example Models
People have different learning styles, but I like to look at running code and then understand how it works. All of the Ascape example models have been converted (a straightforward process) from their intial Ascape incarnations. You can get the projects from the Ascape sourceforge site or SVN. (Link to come.) They're all released under BSD so we can't host them directly on the Eclipse site. Of course you can also run generated Escape models. They're just Java and don't rely on any other artifacts so once they have been generated to the Escape target you can modify them in Java just as with any other Escape model. Simply extract the models and import them into your workspace. To run the models, just right-click on the Java files containing the top-level model and click Run.
Developing Models
The easiest way for Java developers to get started doing agent-based modeling in Eclipse is to begin to write programs using it.To develop new models, you can:
- Create a new Escape project. The Escape projects are actually configured for AMF code generation so there are dependencies and builders in there that you don't need; you can remove all of the escape builders and any of the kitchen sink items. We'll try to get a POJO Escape project wizard out there at some point.
- But it might be simpler to just create a new Plugin Project and add the necessary dependencies there. Have a look at the example escape project to see what you need. Note that you will likely need more dependencies then you need to simply build -- this is because the class loader uses the classes from the project path and so runtime classes have to be there as well. We may simply package an Eclipse runtime convenience plugin to gather these dependencies up a bit.
Then just create new Java classes for your root model scape and agents just as you would for an Ascape project.