fullcontrol

FullControl

FullControl - unconstrained design

fullcontrol allows you to control 3D printers, or other cnc systems, in ways that are not possible using conventional software

you design everything about the print path and print settings, giving you the design freedom to do anything you want

get started without installing anything: go through the interactive tutorial notebooks then use the design template - or install and run things locally as described below

</a>

(youtube playlist)

</a>


think beyond 'normal' 3D printing

intro

the conventional method to generate gcode is: create cad model -> export stl -> slice into layers -> create paths for each layer -> output path as gcode

FullControl offers a different approach where the print path is explicitly designed. imagine being given a hotmelt glue-gun and told to move it around to ‘print’ layers resulting in a 30-mm cube. you could design lots of different paths that would achieve the cube. FullControl allows you to design and preview print paths and convert them to machine-code instructions for a 3D printer (a gcode file)

the overall printing procedure may be considered to be predominantly a stream of points. then a few extra things are sprinkled in occasionally, like changes to speed, temperature, fans, etc.

all of these things together (points and the extra things) are referred to as state in FullControl. state is basically any property of interest that can change

FullControl allows designs to be created that control changes the state of things, where things are anything with state - this initial release of FullControl is focused on the thing being an extrusion 3D printer that is instructed by gcode. however, things really could be anything (laser cutters, assembly lines, non-physical things like a 3D visualization, etc.)

FullControl history

“FullControl gcode designer” (2020) (website, github, journal paper)

“www.fullcontrol.xyz” (2022):

“FullControl” (2023) - this repository:

using FullControl

jupyter notebooks are provided in the docs folder of this github repository (repo) to introduce FullControl and demonstrate its use - browse tutorials: github / colab

you can either use a cloud-based jupyter notebook environment like google colab, or run things locally by installing python and then either jupyterlab or vscode with python and jupyter extensions

a future update of this repo will give more details about the python code

installation

new to python? don’t install - just use the colab design template and get designing straight away online

alternatively, to run locally, install miniconda/anaconda/python and git - if you run into any installation problems, update your versions of python/git/pip

pip install git+https://github.com/FullControlXYZ/fullcontrol

you can also clone this git repo and run “pip install .” from the repo directory

use

to use FullControl, create a python script or jupyter notebook and import the fullcontrol package

import fullcontrol as fc

structure of the repository

the FullControl repository is organized as follows:

workflow for new content

the anticipated workflow for new content is:

  1. demonstrate new ideas with github gists (quick and dirty)
  2. gists inform new additions to the FullControl lab (a little more polished)
  3. lab informs new additions to the main fullcontrol package or models subdirectory

feedback

please use the github issues tab for this repository to give feedback.

pull requests

please submit pull requests for bugfixes, optimizations, documentation corrections/clarifications, etc., and for minor additions and new features such as functions, objects, and modules that fit into the existing package structure

for revisions that change the structure, behaviour, or usage of the software, please email us (info@fullcontrol.xyz) prior to submitting a pull request. this is to ensure alignment between the changes and any planned/unpublished revisions already in progress. note that this version of FullControl is not targeted at developers - the structure of the repo may change and more information about the code structure will be provided at a later date to accommodate contribution more readily

note that the docs folder of this repo contains tutorial notebooks. executing cells in these notebooks leads to timestamp changes, even if the cell content remains unchanged. this may cause unexpected issues and complications for pull requests. until a more automated solution is implemented, consider two options before submitting a pull request:

  1. create a fresh clone of the FullControl repo and copy the relevant changes across (recommended)
  2. use the git stash operation on the docs folder (be careful not to unintentionally stash any of your proper changes though)

license

FullControl is released under the GPL v3 License.

FullControl, FullControlXYZ, copyright 2023 Andrew Gleadall and Dirk Leas

references

until the journal paper for FullControl is available, please cite the paper for ‘FullControl GCode Designer’:

Gleadall, A. (2021). FullControl GCode Designer: open-source software for unconstrained design in additive manufacturing. Additive Manufacturing, 46, 102109.

contact

This site is open source. Improve this page.