AdaCAD is a parametric design tools for making woven drafts. It supports a designer in creating drafts by connecting different operations into a model or pipeline that results in drafts. It currently supports outputs and representations for Jacuqard, Floor, and Direct-Tieup Loom.
You can use the last release of the tool at https://adacad.org/. For more information about the project and user guides, visit https://adacad.unstable.design/
AdaCAD does not require any installing or downloading anything on your device, just open the app in your browser (same link as above).
We invite anyone interested to hack on AdaCAD, should you wish to dive into the code. If that describes you, read on!
There are three core modules in this repo:
-
Core: contains components, services, directives, etc. that are used by both weaver (individual draft view) and mixer (generative workspace) modules. Changes to core will affect both deployments and should be checked before pushing.
-
Weaver: contains all components, services, directives, etc. that are used in "Fine Tune" mode for a given draft. This view supports designing on a simulated loom and viewing yarn paths.
-
Mixer: contains all components, services, directives, etc. that are used to design and control the AdaCAD Mixer. This view supports more freeform and parametric experimentation on stitch structures.
You can use view automatically generated documentation of our project at http://adacad.unstable.design/AdaCAD/.
AdaCAD is built with Angular, a web development framework for progressive web apps. This project was generated with Angular CLI version 7.3.8.
- Node.JS and Node Package Manager (npm)
- Intermediate JavasScript/TypeScript – if you know JavaScript but not TypeScript, it should be fairly easy to pick up TypeScript basics.
- Basic HTML/CSS – enough to understand how these file types are structured and interact with scripts
- The Angular CLI requires a minimum Node.js version of either v12.20, v14.15, or v16.10.
- Clone this repository onto your local hard drive.
- Open your terminal on the local root directory and run
npm installto download the requirements. This can take a while. - Once installed, run
ng servein the terminal and wait for Angular to compile the app. It should tell you once it's ready. If your system doesn't recognizeng serve, make sure that you're in the app and runnode_modules/.bin/ng serve - Navigate to
http://localhost:4200/and you should see AdaCAD!
The information here references Angular documentation, such as this page on Angular concepts and architectural patterns.
- An Angular app like AdaCAD is organized into modules (bundles of functionality), each of which has their directory in
src/app/<module-name>. The modules are currentlycore,mixer, andweaveras described previously. - Each module provides a "view" into the user's design process. The building blocks of these views are Angular components that display some of the data that the user manipulates when designing. Each component has its own subfolder within the module.
- Components don't handle the actual data manipulation, such as editing drafts or logging the user's history of design operations. For that, we have Angular services, which components use as dependencies. Each module has a
providersubdirectory (e.g.src/app/core/provider) that holds the relevant services. - Many of the files in the repository are automatically generated by the Angular CLI to make each component or service function properly. See the Code scaffolding section for some useful commands when making a new entity.
AdaCAD is a large (and growing) application and chances are that you will only need to touch a few files when implementing or augmenting it to your own needs. We are slowly migrating the code from impertive/object-oriented styles to functional/reactive styles, so there is a mixture of styles in this base. Here, we will list the files in which you can find core information or action points for the program:
You can find a description of all of the core datatypes used in AdaCAD at /core/model/datatypes.ts.
-
Cell - This is a single cell or square within the draft. It has two boolean values, one describing the position of the heddle as up/raised or down/lowered, and the second relating to whether or not a weft travels over the warp at this location, which is required for inlay weaving and certain elements of simulation. This value can be set/true or unset/false.
-
Drawdown - A drawdown is the actual pattern of cells and values that make up the weaving draft. For the purposes of computation the cell at [0][0] always corresponds to the top left corner of the draft in memory.
-
Draft - A draft stores the drawdown as well as arrays mapping each warp/weft in the draft to a unique material_id, and system_id. Each draft has a unique id, which allows us to crosslink draft inforamation between the model (data) and view components.
-
Loom - A Loom is simply a collection of arrays representing the threading, tieup and threadling.
-
LoomUtil - A loom utility describes a particular kind of loom (jacquard, direct tieup, etc.) and contains all the functions neccessary for producing a threading, tieup and treadling from a drawdown and vice versa.
-
Tree - The tree is a data representation of the relaitonships between operations and drafts within the mixer. It is the "brain" of AdaCAD and stores all information relating to screen position of the design components, their current parameter vaues, and their parent/child relationships to other on screen design elements.
-
Operation - An operation holds all data required to compute specific chagnes to an input draft. The operation object holds information about the kind of data it can receive and how it manipulates that data. All operations available in AdaCAD are described in: (stored in /mixer/provider/operation.service.ts). Adding a new operation at this location adds it to the entire app, without requiring the user to make any custom UI elements for the operation.
The mixer describes the parametric design view of the AdaCAD interface. This view consists of the following:
-
Palette - this is the visual space of all the design elements in the mixer
-
Subdraft - this is the view that holds the visual represeention and provided options on any draft on view in AdaCAD
-
Operation - this is the view that holds the visual representation of each operation. The operation consists of subtypes: Inlet, which governs the type of input this operation can receive, Parameter, which describe how to represent and validate parameter inputs on screen. The data used to generate inlets and parameters is described by the operation (stored in /mixer/provider/operation.service.ts)
-
Connection - this is the visual represenation of the connection between drafts and operations.
-
Weaver - the weaver is separate module from the mixer which stores all the UI features that the user sees and uses when they expand or "Fine Tune" a draft.
The Angular CLI provides built-in commands to generate the utility files for components, services, and other such things categorized as "schematics". These files will be generated in the current directory of the terminal, so navigate to the appropriate subdirectory first.
- New component:
- Make a subfolder in the appropriate module named
<component-name> - In this subfolder, run
ng generate component <component-name>
- Make a subfolder in the appropriate module named
- New service:
- In the appropriate module's
providersubfolder, runng generate service <service-name>
- In the appropriate module's
- For other options, refer to the Angular CLI documentation.
Run ng serve for a dev server. Navigate to http://localhost:4200/. The app will automatically reload if you save changes in any of the source files.
Run ng build to build the project. The build artifacts will be stored in the dist/ directory. Use the -prod flag for a production build.
To get more help on the Angular CLI, use ng help or go to the Angular CLI README.