Virtual Satellite 4 - FreeCAD Module is an extension for FreeCAD, an Open Source 3D Parametric Modeler. This extension allows to create a round-trip engineering workflow with Virtual Satellite.
Note: This extension is still under development. It is not ready for productive use and is subject to constant change.
| Master | Development |
|---|---|
 |
 |
Virtual Satellite 4 FreeCAD Module is an extension to FreeCAD. FreeCAD is an open source mechanical engineering CAD tool. The extension can be easily installed to FreeCAD. It allows to import structural configuration information into FreeCAD and keep it consistently synchronized with Virtual Satellite
This program is based on FreeCAD and Python. The following infrastructure is required:
- FreeCAD 0.18 and higher (64bit)
- A2plus Workbench 0.4.26 and higher
- Virtual Satellite 4
If you just want to use Virtual Satellite feel free to download it from the Releases section here on GitHub.
To set up your Eclipse IDE, run the Apache ANT build.xml. It works for Windows and Linux systems.
The Ant script is performing the following steps:
- Install FreeCAD.
- Install the A2plus Workbench.
- Apply need patches (To fix some interim bugs in FreeCAD)
If you have FreeCAD already installed and you only want to install this extension, please follow these steps:
- Find the default configuration path to FreeCAD (e.g.
~/.FreeCAD/on Linux) - Type
cd path/to/your/.FreeCAD/Modto change directory to your default configuration Mod subdirectory. - Download the extension zip file (from Releases) into this directory and unzip it.
- Start or Restart FreeCAD.
Note: You can get the configuration directory by using the FreeCAD's python console: FreeCAD.ConfigGet("UserAppData")
Note: A git clone method compared to copying and unzipping is preferred. Updates are conveniently done with a simple git fetch instead of needing to re-download the zip file and unzipping it.
The Virtual Satellite Workbench is now available in FreeCAD
Travis CI is set-up to start a build job for every branch and every new commit to the repository. It executes all relevant tests. Making a successful pull-request into development requires all tests to pass.
Starting a Travis CI job on development deploys all relevant artifacts.
For creating a new release, create a tag starting with Release_ on the master branch. All artifacts are automatically deployed.
- A new Virtual Satellite Workbench
- Functionality to upload a design to Virtual Satellite.
- Functionality to download a design from Virtual Satellite.
We are happy to receive your contributions. Nevertheless in such a big project there is a lot to respect and to obey. One thing to respect are legal requirements such as authorship rights and privacy protection. Therefore, before we can accept your contributions we need you to sign our Contributor License Agreement (CLA).
Please follow the process described in Virtual Satellite 4 - Core to become an authorized contributor.
Once you are an authorized committer feel free to contribute. We will not activate your account within our organization. Therefore use Pull-Requests to contribute:
- Create your own fork of the project.
- Apply your changes.
- Create a pull-request of your change to our development branch.
To increase chance that we accept your pull-request, make sure all tests are working. The best indicator is the Travis CI job. Next we will review your pull-request, give comments and maybe accept it.
The Apache Ant script for the build process has following third party dependencies:
- Apache Compress Ant Library: Apache License 2.0
- Apache Commons Compress: Apache License 2.0
- XZ for Java: public domain
The final FreeCAD Module (see Releases) does NOT have those third party dependencies.
Copyright (C) 2019 by
DLR (German Aerospace Center), Software for Space Systems and interactive Visualization Braunschweig, Germany
This program is free software: you can redistribute it and/or modify it under the terms of the GNU Lesser General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.
This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.
You should have received a copy of the GNU Lesser General Public License along with this program. If not, see https://www.gnu.org/licenses/.