From d0996b702d40c905e0216fd3a496c218f2e73d6c Mon Sep 17 00:00:00 2001 From: TrickyBytes Date: Thu, 5 May 2016 15:53:18 +0100 Subject: [PATCH] Initial commit --- README.md | 33 +++++++++++++++++++++++++++++++++ nhm-bundle-api | 1 + nhm-ide | 1 + nhm-impl-bundle | 1 + 4 files changed, 36 insertions(+) create mode 100644 README.md create mode 160000 nhm-bundle-api create mode 160000 nhm-ide create mode 160000 nhm-impl-bundle diff --git a/README.md b/README.md new file mode 100644 index 0000000..69c188a --- /dev/null +++ b/README.md @@ -0,0 +1,33 @@ +# Synopsis +This repository holds the projects necessary to build the National Household Model Standalone (IDE), the IDE utilises the open-source [Eclipse] (http://www.eclipse.org/) IDE and adds customisation to allow the editing of scenarios (a *DSL for describing simulation events for the National Household Model), importing house stocks from structured CSV files and running simulations using the model. The implementation of the model is available from a separate repository detailed in External Project Dependencies. + +# Installation +To build the Standalone project locally both the OSGI Bundles, [National Household Model] (https://github.com/cse-bristol/national-household-model-core-components) and [National Household Model Documentation] (https://github.com/cse-bristol/national-household-model-documentation) need to be compiled as jars and installed within a local Maven repository. + +## OSGI Bundles +OSGI is the way customisation's can be added to the Eclipse IDE, typically these should be compiled and hosted in a P2 repository, the repository location should then be defined in the repositories element of the IDE pom file. + +### API - nhm-api-bundle +Defines the Application Programming Interface for an NHM Bundle. This is a Gradle project and should be configured to push the generated p2 bundle into a p2 repository. + +### IMPL - nhn-bundle-impl +This is an implementation of the API bundle, the project will need to be updated when the IDE needs to include new commits to [National Household Model] (https://github.com/cse-bristol/national-household-model-core-components) or [National Household Model Documentation] (https://github.com/cse-bristol/national-household-model-documentation). Again this is a Gradle project and has the same installation requirements as the API Bundle. See the Gradle build file for current dependencies. + +## Standalone - Eclipse IDE +Uses Maven(3) to build the project. + +This is the customised Eclipse IDE, in order to build correctly it depends on API Bundle, IMPL Bundle and [National Household Model Documentation] (https://github.com/cse-bristol/national-household-model-documentation). The Model and Documentation projects should be either installed in a local or remote repository, the Bundles should be available in a local or remote P2 repository. The locations of remote respositories can be configured in the repositories element of the build file (pom.xml). + +Creates Standalone binaries for the linux (32 and 64 bit), Windows (32/64 bit) and Mac OSX Cocoa. + +In order to sign the created application you will need to 'sign' the build with a secure key, the location of the keystore and passphrase can be configured in your maven settings file. See the maven-jarsigner-plugin in the pom file. + +## External Project Dependencies +1. [National Household Model] (https://github.com/cse-bristol/national-household-model-core-components) - This is the model part of the National House Hold model. +2. [National Household Model Documentation] (https://github.com/cse-bristol/national-household-model-documentation) - Provides the help/reference guide to the NHM within the IDE. + +## Binaries - Compiled Executables of the Standalone IDE +TODO + +# License +[Open Government License] (http://www.nationalarchives.gov.uk/doc/open-government-licence/version/3/) diff --git a/nhm-bundle-api b/nhm-bundle-api new file mode 160000 index 0000000..f437a5c --- /dev/null +++ b/nhm-bundle-api @@ -0,0 +1 @@ +Subproject commit f437a5c46152875b1cd7a9c215a4f165cfdb2d98 diff --git a/nhm-ide b/nhm-ide new file mode 160000 index 0000000..f27f016 --- /dev/null +++ b/nhm-ide @@ -0,0 +1 @@ +Subproject commit f27f0160fc22ab81efae42912af9b3c8bb46b74e diff --git a/nhm-impl-bundle b/nhm-impl-bundle new file mode 160000 index 0000000..e6be7a0 --- /dev/null +++ b/nhm-impl-bundle @@ -0,0 +1 @@ +Subproject commit e6be7a0713f06debc7d708b5efea2e6ca5c149f8