Copyright (c) Vanderbilt University, 2004-2013 ALL RIGHTS RESERVED ** GReAT: Graph Rewriting And Transformations ** ** Software Requirements ** 1. Windows Operating system (XP, Vista, 7) 2. GME, 14.10.10 or compatible from: http://repo.isis.vanderbilt.edu/GME NOTE: You need to have administrative privileges to install GME correctly. 3. UDM 3.2, 3.2.13 or compatible from: http://repo.isis.vanderbilt.edu/UDM 4. Visual Studio 2008 (VC9) or Visual Studio 2010 (VC10) (This version of GReAT can also be used with Visual C++ 2010 Express Please visit http://www.microsoft.com/eXPress/download/#webInstall for instructions on how to download and install the free express edition) PLEASE DOWNLOAD AND INSTALL 2, 3, and 4 before proceeding. ** Install instructions ** 1. If upgrading from GReAT 1.7.4 or earlier, export all previous transformation files to .xme 2. Uninstall previous version of GReAT 3. Run the GReAT installer 4. ** If you are upgrading from GReAT r1.1, run UPC.exe on previous model xme files to generate new xme files (You need to add mga.dtd to the user path or copy it to the local directory). Now you should be able to import the generated transformations in the new paradigm. 5. Read the GReAT User Manual for instructions on how to use GReAT and its associated tools. 6. To run the samples, please read the readme in each sample's directory. The GReAT Samples directory is under Public Documents. ** Known Issues ** If you have generated code projects from v1.7.2 or before: Add $(GREAT_PATH)\include to preprocessor include directories Remove $(GREAT_PATH)\etc from preprocessor include directories Add $(GREAT_PATH)\lib to library directories If you have generated code projects from v1.7.1 or before: Change paths from C:\Program Files\ISIS\GReAT\tmp to $(TMP)\GReAT To run the samples on Windows Vista or 7, copy the Samples folder to a writeable directory (e.g. Documents). User code libraries compatibility requirements: 1. If Udm features are used, you are required to specify UDM_DYNAMIC_LINKING preprocessor directive in the project options. This is needed because the generated files are linked against UdmDll(d).lib. 2. You must conform to the library naming convention of using the 'd' suffix for debug libraries. The generated project file links with d.lib for Debug configuration, and .lib for Release configuration. Porting your old UMT models (pre GReAT v1.6.0): You can import your old UMT models using the "Import XML" feature in GME. The UserCodeLibrary has been moved from the Config model to the UserCodeLibrary model. If your old model contains UserCodeLibraries, it must be moved to the UserCodeLibrary model. This can be done automatically, by using the XSLT script found here: $\GReAT\etc\UmtUpdater.xls. ---------------------- Folder structure ---------------------- Program Files\ISIS\GReAT: bin/ Executables, DLLs doc/ Documents etc/ Helper files for the user code compilers,etc. lib/ Library files meta/ Metamodel files include/ C header files for generated code Public Documents: samples/ Contains some GReAT samples ---------------------- Changelog ---------------------- 10/20/14 - Release 1.7.8 1. UMTHelper: don't attempt to delete new connections originating from a Group. (Thanks to Simon Görke for the bug report) 2. UMTHelper: don't set Group.Criteria for copies. (Thanks to Simon Görke for the bug report) 3. CodeGenerator nested namespace fix. (Thanks to Tim Belschner) 01/25/13 - Release 1.7.7 1. Fix COM registration 02/02/12 - Release 1.7.6 1. Udm 3.2.10 compatibility 2. Single-line comments are allowed at the end of AttributeMappings 3. GReAT master interpreter: 'R' button no longer resets the dialog 12/01/10 - Release 1.7.5 1. update to GME 10.8.18 2. Add Visual Studio 2010 compatible components 3. Fix Blockify interpreter bugs when references and refports are used (GRT-98) 4. Change UMTDecorator CLSID so it doesn't conflict with UMLDecorator (GRT-99) 5. Don't allow type of ClassCopys to be in-place modified via UMTDecorator(GME-304) 6. Fix LibraryUpdate interpreter when old library is in a library and new is not (or vice versa) 7. GReAT Debugger Interpreter: allow navigation from debugger window to GME model element 04/15/10 - Release 1.7.4 1. update to GME 10.2.9 2. update to boost 1.42 with dynamic link 01/09/10 - Release 1.7.3 1. Update to GME 9.12.15 2. Update to UDM 3.2.3 3. CodeGenerator produces code for runtime traceability 11/30/09 - Release 1.7.2 1. update with GME 9.11.12 2. Updated with UDM 3.2.2 3. Bug fixes 4. GREngine produces runtime traceability information 5. Generated files are located in $TMP instead of c:\Program Files\GReAT\tmp 09/03/09 - Release 1.7.1 1. update with GME 9.8.28 2. Updated with UDM 3.2.1 3. Bug fix 12/11/08 - Release 1.6.2 1. Updated with UDM 3.1.3 2. Bug fix 6/29/07 - Release 1.6.1 1. GME 7.6.29 support 2. Nested UML namespaces support 3. Group language feature full support with GREngine and CodeGenerator 4. UMTDecorator is updated to show the full namespace path 5. MasterInterpreter GUI is updated with added checkboxes. 11/22/06 - Release 1.6.0 1. GME 6.9.11 support 2. "Blockify" tool: select a sequence of adjacent rules, invoke tool, and the rules are automatically grouped into a block with connections made automatically (see User's guide for details) 3. Group language feature added (see the GReAT User's guide for details) 4. Template rule support 5. "NextRuleGenerator" tool: select a rule, invoke the tool and the next rule in sequence with connections made automatically. 04/06/06 - Release 1.5.1 1. GME 5.11.18 support 2. Fixed UMTHelper (decorator) bug dealing with association class references. 3. Updated the UMLModelTransformer paradigm to no longer use connection proxies. 4. Support for Visual Studio 2005, including updated 3rdParty libraries. 5. VS 2005 version no longer uses the .dll version of the boost libraries (uses static linking). Known Issue: If you are using VS 2008 Express Edition, please be sure to install the SDK (separate install) by following the instructions given here: http://www.microsoft.com/eXPress/download/#webInstall In some cases, the vsvars32.bat file may not be updated with the correct LIB paths, and this may cause errors in some GReAT tools. If you encounter a linking error, please edit the vsvars32.bat, contained in (your VS9 directory)/Common7/Tools and make sure (your platform SDK)\lib folder is added in the LIB paths. For instance, @set LIB=C:\Program Files\Microsoft Platform SDK\lib;%LIB% 11/07/05 - Release 1.5.0 1. GME 5.9.21 support 2. Configuration editor tool: a dialog based interface for specyfing configuration data 3. Port connector tool: select two rules, press a button and the tool will connect all the ports based on the physical layout of the ports. 4. Match-any-association language feature (see the GReAT User's guide for details) 5. GME enum bug fixed in MetaGME2UMx (see JIRA issue GRT-47) 07/15/05 - Release 1.4.1 1. Fixed MetaGME2UML/MetaGME2UMT bug dealing with GME proxies 2. GReAT Tutorial added 3. OCL method support added to UdmOCLPat 4. Minor Udm bugfixes 06/13/05 - Release 1.4.0 1. VC71 support: This means (1) all UDM and GReAT tools and core libraries are compiled with VC71; (2) all the tools produce cpp files and Visual Studio project files for VS7. 2. Global namespace: use the temporary attribute of Class Packages in your UMT models, and you'll be able to access a global root object from all the rules without passing it as a packet. (for an example, see SignalFlow2FlatSF_test_globalObject) 3. Sorting: specify a compare function in CodeLibrary under your Configuration folder, and use that compare function in the specification of an output port to sort the rule's output packets. (for an example, see SignalFlow2FlatSF_test_sortingFunc) 4. Distinguished cross product: set the "Distinguished cross product" attribute true, so that each object is allowed to occur only once among the results, i.e. all objects will be unique. (for an example, see SignalFlow_test_distinguished) 5. The code generator now automatically generates VS7 project files, so that you don't have to set up the project manually. The command line tool, CG.exe, can also compile the generated files, i.e. it can generate the transformation executable file. (see the command line help of CG.exe for more info) 6. You can call the compare functions specifications in Guard and AM code. Code library is a future placeholder for code snippets, that can be called from Guard and AM code. 11/12/04 - Release 1.3.3 1. Updated to GME 4, R4.11.10. Please install GME4.11.10 first. 09/28/04 - Release 1.3.2 1. Require GME 4, R4.8.25 2. Support multiple models of the same meta. 3. Support UserCode library. In configuration model, user can define some other required include and library files, also user needs to specify the directories for these files. 4. Some bug fixes. 06/18/04 - Release 1.3.1 1. Minor bugfixes: -in umt cross link diagram PatternAssociation and PatternComposition links are not allowed, and a constraint has been added that checks if there are any of them present in the diagram. - in uml class diagram, if the association end has blank name, the Class name will be used as default name. 2. Please note the change of the software license. 06/04/04 - Release 1.3.0 1. GReAT has been ported to GME4. 2. The MetaGME2UML interpreter now supports interface inheritance, implementation inheritance and equivalence operators. 3. The GReAT engine now supports direct manipulation of in/out files. 4. Temporary links within the same paradigm are now supported. 5. Some minor bugfixes 05/06/04 - Release 1.2.4 1. Added support for cross links within the same paradigm 2. Added support for (1) Implementation Inheritance, (2) Interface Inheritance, (3) Equivalence, in MetaGME. 04/09/04 - Release 1.2.3 1. UMT paradigm has changed. UPC.exe provided to migrate previous models. 2. UML paradigm has changed. UPC.exe can be used to migrate previous models. 3. Bug fixes in the master interpreter (including the one reported by Gabor Madl) 4. Bug fixes in GRE and GRD (reported by Tivadar) 5. GReAT Master interpreter dialog has a new "R" to be used when transformations have been moved to a different directory or computer. 6. Automated rolenames when connector connected to association class. 7. Code generator now supports direct manipulation of in/out files. ------------ Copyright ------------ Copyright (c) Vanderbilt University, 2004-2010 Permission is granted to use this software for academic/research purposes ALL RIGHTS RESERVED Vanderbilt University disclaims all warranties with regard to this software, including all implied warranties of merchantability and fitness. In no event shall Vanderbilt University be liable for any special, indirect or consequential damages or any damages whatsoever resulting from loss of use, data or profits, whether in an action of contract, negligence or other tortious action, arising out of or in connection with the use or performance of this software.