The Metamorphosys tools can be compiled from the source code in this repository. Compilation requires a Windows PC and access to the internet (for downloading NuGet packages).
Follow these configuration instructions, in order, to set up your machine to build the Metamorphosys tools from source.
Install Windows updates until your version is current
Install Microsoft .NET Framework, version 4.0 or higher.
Version 4.5.1 can be found here
NOTE: Will not compile under Express Edition
When installing, select these packages (at minimum):
- C++
- C#
- Office Tools
Get the latest Python 2.7 (2.7.8 at the time of writing). Make sure the .py extension is associated with Python 2.7, and it is installed for All Users (NOT ”just for me”). Download it here (and don’t get the 64-bit version).
Get pywin32-219.win32-py2.7.exe here
Again, don't get the 64-bit version.
Download 3.x here (get the newest 3.x version).
3.5, 3.6, 3.7, 3.8 are detected by the build_msi.py script.
NOTE: Either x86 or x64 is okay
Set environment variable JAVA_HOME to the installed directory, such as C:\Program Files (x86)\Java\jdk1.7.0_09
The real name of the subdirectory depends on what version you have installed.
GME_x64 is the best-tested (but 32-bit should work too)
If you intend to develop Android apps on the compile machine, install the Android SDK Bundle. If you don't, then you will only need the Stand-alone SDK Tools.
Install the Android 4.3 (API 18) package (at minimum).
Download ANT version 1.9.4 here
Unzip ANT to %APPDATA%\Local such that its full path is %APPDATA%\Local\apache-ant-1.9.4
Again, install Windows updates until everything is current. Restart your computer.
FreeCAD is an open-source parametric 3D CAD modeling program. META uses FreeCAD to assemble component CAD models to provide a 3D visual representation of a user's model. It is required for the CyPhy2CADPCB visualizing test benches.
CadQuery is a plugin for FreeCAD that provides a library of Python functions for the manipulation of solid geometry. These functions are used to transform the local coordinate system of a component's CAD model to the correct position and orientation in the assembly coordinate system. It is required for the CyPhy2CADPCB visualizing test benches.
To install:
- Download zip file above and extract contents.
- Copy the CadQuery folder into
<FreeCAD_Install_Dir>\Mod
NOTE: The CadQuery library must be copied into the <FreeCAD_Install_Dir>\Mod folder to work correctly with the META tools.
git.exe must be in your PATH. For msysgit, select Use Git from the Windows Command Prompt during installation.
Clone this repository to your disk.
- Open Visual Studio Command Prompt (2010) with ”Run as administrator”
- From the root repository directory, run
build_both.cmd. This may take 30 minutes to build. (Warnings may be ignored, but there should be no errors.)
If you encounter errors, try to build once more. There may be some remaining race conditions in the build scripts.
For first-time users, Walkthrough Documentation is a good introduction to using the tools. More advanced capabilities are explored in the META Case Studies.