Skip to content

Commit

Permalink
GITBOOK-6: No subject
Browse files Browse the repository at this point in the history
  • Loading branch information
juney-lee authored and gitbook-bot committed Nov 21, 2024
1 parent 96dc149 commit c6ac635
Show file tree
Hide file tree
Showing 255 changed files with 1,293 additions and 0 deletions.
Binary file added gitbook/.gitbook/assets/ags_sequence-01.jpg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added gitbook/.gitbook/assets/ags_sequence-02.jpg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added gitbook/.gitbook/assets/ags_sequence-03.jpg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added gitbook/.gitbook/assets/ags_sequence-04.jpg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added gitbook/.gitbook/assets/ags_sequence-05.jpg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added gitbook/.gitbook/assets/ags_sequence-06.jpg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added gitbook/.gitbook/assets/ags_sequence-07.jpg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added gitbook/.gitbook/assets/ags_sequence-08.jpg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added gitbook/.gitbook/assets/ags_sequence-09.jpg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added gitbook/.gitbook/assets/ags_sequence-10.jpg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added gitbook/.gitbook/assets/ags_sequence-11.jpg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added gitbook/.gitbook/assets/ags_sequence-12.jpg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added gitbook/.gitbook/assets/ags_sequence-13.jpg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added gitbook/.gitbook/assets/ags_sequence-14 (1).jpg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added gitbook/.gitbook/assets/ags_sequence-14.jpg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added gitbook/.gitbook/assets/compas_ags_poster.jpg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added gitbook/.gitbook/assets/iags_diagrams-03.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added gitbook/.gitbook/assets/iags_diagrams-04.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added gitbook/.gitbook/assets/image (1).png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added gitbook/.gitbook/assets/image (10).png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added gitbook/.gitbook/assets/image (100).png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added gitbook/.gitbook/assets/image (101).png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added gitbook/.gitbook/assets/image (102).png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added gitbook/.gitbook/assets/image (103).png
Binary file added gitbook/.gitbook/assets/image (104).png
Binary file added gitbook/.gitbook/assets/image (105).png
Binary file added gitbook/.gitbook/assets/image (106).png
Binary file added gitbook/.gitbook/assets/image (107).png
Binary file added gitbook/.gitbook/assets/image (108).png
Binary file added gitbook/.gitbook/assets/image (109).png
Binary file added gitbook/.gitbook/assets/image (11).png
Binary file added gitbook/.gitbook/assets/image (110).png
Binary file added gitbook/.gitbook/assets/image (111).png
Binary file added gitbook/.gitbook/assets/image (112).png
Binary file added gitbook/.gitbook/assets/image (113).png
Binary file added gitbook/.gitbook/assets/image (114).png
Binary file added gitbook/.gitbook/assets/image (115).png
Binary file added gitbook/.gitbook/assets/image (116).png
Binary file added gitbook/.gitbook/assets/image (117).png
Binary file added gitbook/.gitbook/assets/image (118).png
Binary file added gitbook/.gitbook/assets/image (119).png
Binary file added gitbook/.gitbook/assets/image (12).png
Binary file added gitbook/.gitbook/assets/image (120).png
Binary file added gitbook/.gitbook/assets/image (121).png
Binary file added gitbook/.gitbook/assets/image (122).png
Binary file added gitbook/.gitbook/assets/image (123).png
Binary file added gitbook/.gitbook/assets/image (124).png
Binary file added gitbook/.gitbook/assets/image (125).png
Binary file added gitbook/.gitbook/assets/image (126).png
Binary file added gitbook/.gitbook/assets/image (127).png
Binary file added gitbook/.gitbook/assets/image (128).png
Binary file added gitbook/.gitbook/assets/image (129).png
Binary file added gitbook/.gitbook/assets/image (13).png
Binary file added gitbook/.gitbook/assets/image (130).png
Binary file added gitbook/.gitbook/assets/image (131).png
Binary file added gitbook/.gitbook/assets/image (132).png
Binary file added gitbook/.gitbook/assets/image (133).png
Binary file added gitbook/.gitbook/assets/image (134).png
Binary file added gitbook/.gitbook/assets/image (135).png
Binary file added gitbook/.gitbook/assets/image (136).png
Binary file added gitbook/.gitbook/assets/image (137).png
Binary file added gitbook/.gitbook/assets/image (138).png
Binary file added gitbook/.gitbook/assets/image (139).png
Binary file added gitbook/.gitbook/assets/image (14).png
Binary file added gitbook/.gitbook/assets/image (140).png
Binary file added gitbook/.gitbook/assets/image (141).png
Binary file added gitbook/.gitbook/assets/image (142).png
Binary file added gitbook/.gitbook/assets/image (143).png
Binary file added gitbook/.gitbook/assets/image (144).png
Binary file added gitbook/.gitbook/assets/image (145).png
Binary file added gitbook/.gitbook/assets/image (146).png
Binary file added gitbook/.gitbook/assets/image (147).png
Binary file added gitbook/.gitbook/assets/image (148).png
Binary file added gitbook/.gitbook/assets/image (149).png
Binary file added gitbook/.gitbook/assets/image (15).png
Binary file added gitbook/.gitbook/assets/image (150).png
Binary file added gitbook/.gitbook/assets/image (151).png
Binary file added gitbook/.gitbook/assets/image (152).png
Binary file added gitbook/.gitbook/assets/image (153).png
Binary file added gitbook/.gitbook/assets/image (154).png
Binary file added gitbook/.gitbook/assets/image (155).png
Binary file added gitbook/.gitbook/assets/image (156).png
Binary file added gitbook/.gitbook/assets/image (157).png
Binary file added gitbook/.gitbook/assets/image (158).png
Binary file added gitbook/.gitbook/assets/image (159).png
Binary file added gitbook/.gitbook/assets/image (16).png
Binary file added gitbook/.gitbook/assets/image (160).png
Binary file added gitbook/.gitbook/assets/image (161).png
Binary file added gitbook/.gitbook/assets/image (162).png
Binary file added gitbook/.gitbook/assets/image (163).png
Binary file added gitbook/.gitbook/assets/image (164).png
Binary file added gitbook/.gitbook/assets/image (165).png
Binary file added gitbook/.gitbook/assets/image (166).png
Binary file added gitbook/.gitbook/assets/image (167).png
Binary file added gitbook/.gitbook/assets/image (168).png
Binary file added gitbook/.gitbook/assets/image (169).png
Binary file added gitbook/.gitbook/assets/image (17).png
Binary file added gitbook/.gitbook/assets/image (170).png
Binary file added gitbook/.gitbook/assets/image (171).png
Binary file added gitbook/.gitbook/assets/image (172).png
Binary file added gitbook/.gitbook/assets/image (173).png
Binary file added gitbook/.gitbook/assets/image (174).png
Binary file added gitbook/.gitbook/assets/image (175).png
Binary file added gitbook/.gitbook/assets/image (176).png
Binary file added gitbook/.gitbook/assets/image (177).png
Binary file added gitbook/.gitbook/assets/image (178).png
Binary file added gitbook/.gitbook/assets/image (179).png
Binary file added gitbook/.gitbook/assets/image (18).png
Binary file added gitbook/.gitbook/assets/image (180).png
Binary file added gitbook/.gitbook/assets/image (181).png
Binary file added gitbook/.gitbook/assets/image (182).png
Binary file added gitbook/.gitbook/assets/image (183).png
Binary file added gitbook/.gitbook/assets/image (184).png
Binary file added gitbook/.gitbook/assets/image (185).png
Binary file added gitbook/.gitbook/assets/image (186).png
Binary file added gitbook/.gitbook/assets/image (187).png
Binary file added gitbook/.gitbook/assets/image (188).png
Binary file added gitbook/.gitbook/assets/image (189).png
Binary file added gitbook/.gitbook/assets/image (19).png
Binary file added gitbook/.gitbook/assets/image (190).png
Binary file added gitbook/.gitbook/assets/image (191).png
Binary file added gitbook/.gitbook/assets/image (192).png
Binary file added gitbook/.gitbook/assets/image (193).png
Binary file added gitbook/.gitbook/assets/image (2).png
Binary file added gitbook/.gitbook/assets/image (20).png
Binary file added gitbook/.gitbook/assets/image (21).png
Binary file added gitbook/.gitbook/assets/image (22).png
Binary file added gitbook/.gitbook/assets/image (23).png
Binary file added gitbook/.gitbook/assets/image (24).png
Binary file added gitbook/.gitbook/assets/image (25).png
Binary file added gitbook/.gitbook/assets/image (26).png
Binary file added gitbook/.gitbook/assets/image (27).png
Binary file added gitbook/.gitbook/assets/image (28).png
Binary file added gitbook/.gitbook/assets/image (29).png
Binary file added gitbook/.gitbook/assets/image (3).png
Binary file added gitbook/.gitbook/assets/image (30).png
Binary file added gitbook/.gitbook/assets/image (31).png
Binary file added gitbook/.gitbook/assets/image (32).png
Binary file added gitbook/.gitbook/assets/image (33).png
Binary file added gitbook/.gitbook/assets/image (34).png
Binary file added gitbook/.gitbook/assets/image (35).png
Binary file added gitbook/.gitbook/assets/image (36).png
Binary file added gitbook/.gitbook/assets/image (37).png
Binary file added gitbook/.gitbook/assets/image (38).png
Binary file added gitbook/.gitbook/assets/image (39).png
Binary file added gitbook/.gitbook/assets/image (4).png
Binary file added gitbook/.gitbook/assets/image (40).png
Binary file added gitbook/.gitbook/assets/image (41).png
Binary file added gitbook/.gitbook/assets/image (42).png
Binary file added gitbook/.gitbook/assets/image (43).png
Binary file added gitbook/.gitbook/assets/image (44).png
Binary file added gitbook/.gitbook/assets/image (45).png
Binary file added gitbook/.gitbook/assets/image (46).png
Binary file added gitbook/.gitbook/assets/image (47).png
Binary file added gitbook/.gitbook/assets/image (48).png
Binary file added gitbook/.gitbook/assets/image (49).png
Binary file added gitbook/.gitbook/assets/image (5).png
Binary file added gitbook/.gitbook/assets/image (50).png
Binary file added gitbook/.gitbook/assets/image (51).png
Binary file added gitbook/.gitbook/assets/image (52).png
Binary file added gitbook/.gitbook/assets/image (53).png
Binary file added gitbook/.gitbook/assets/image (54).png
Binary file added gitbook/.gitbook/assets/image (55).png
Binary file added gitbook/.gitbook/assets/image (56).png
Binary file added gitbook/.gitbook/assets/image (57).png
Binary file added gitbook/.gitbook/assets/image (58).png
Binary file added gitbook/.gitbook/assets/image (59).png
Binary file added gitbook/.gitbook/assets/image (6).png
Binary file added gitbook/.gitbook/assets/image (60).png
Binary file added gitbook/.gitbook/assets/image (61).png
Binary file added gitbook/.gitbook/assets/image (62).png
Binary file added gitbook/.gitbook/assets/image (63).png
Binary file added gitbook/.gitbook/assets/image (64).png
Binary file added gitbook/.gitbook/assets/image (65).png
Binary file added gitbook/.gitbook/assets/image (66).png
Binary file added gitbook/.gitbook/assets/image (67).png
Binary file added gitbook/.gitbook/assets/image (68).png
Binary file added gitbook/.gitbook/assets/image (69).png
Binary file added gitbook/.gitbook/assets/image (7).png
Binary file added gitbook/.gitbook/assets/image (70).png
Binary file added gitbook/.gitbook/assets/image (71).png
Binary file added gitbook/.gitbook/assets/image (72).png
Binary file added gitbook/.gitbook/assets/image (73).png
Binary file added gitbook/.gitbook/assets/image (74).png
Binary file added gitbook/.gitbook/assets/image (75).png
Binary file added gitbook/.gitbook/assets/image (76).png
Binary file added gitbook/.gitbook/assets/image (77).png
Binary file added gitbook/.gitbook/assets/image (78).png
Binary file added gitbook/.gitbook/assets/image (79).png
Binary file added gitbook/.gitbook/assets/image (8).png
Binary file added gitbook/.gitbook/assets/image (80).png
Binary file added gitbook/.gitbook/assets/image (81).png
Binary file added gitbook/.gitbook/assets/image (82).png
Binary file added gitbook/.gitbook/assets/image (83).png
Binary file added gitbook/.gitbook/assets/image (84).png
Binary file added gitbook/.gitbook/assets/image (85).png
Binary file added gitbook/.gitbook/assets/image (86).png
Binary file added gitbook/.gitbook/assets/image (87).png
Binary file added gitbook/.gitbook/assets/image (88).png
Binary file added gitbook/.gitbook/assets/image (89).png
Binary file added gitbook/.gitbook/assets/image (9).png
Binary file added gitbook/.gitbook/assets/image (90).png
Binary file added gitbook/.gitbook/assets/image (91).png
Binary file added gitbook/.gitbook/assets/image (92).png
Binary file added gitbook/.gitbook/assets/image (93).png
Binary file added gitbook/.gitbook/assets/image (94).png
Binary file added gitbook/.gitbook/assets/image (95).png
Binary file added gitbook/.gitbook/assets/image (96).png
Binary file added gitbook/.gitbook/assets/image (97).png
Binary file added gitbook/.gitbook/assets/image (98).png
Binary file added gitbook/.gitbook/assets/image (99).png
Binary file added gitbook/.gitbook/assets/image.png
Binary file added gitbook/.gitbook/assets/overview_4-01.jpg
11 changes: 11 additions & 0 deletions gitbook/README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,11 @@
---
description: Intteractive Graphic Statics in 2D based on compas_ags
---

# Interactive 2D Graphic Statics (IGS2)

![](.gitbook/assets/plugin\_title\_slides\_compas\_ags.jpg)

## About

Graphic statics is a well-known method for analysis and design of two-dimensional structures based on Cremona’s extensions of Maxwell’s theory of reciprocal figures. In graphic statics, the relation between form and forces of a structural system is contained in the reciprocal relation between two diagrams. A form diagram describes the geometrical configuration of the (axial) internal and external forces of a two-dimensional structural system, and a force diagram represents their equilibrium. The combination of these two diagrams allows for an intuitive evaluation of structural behaviour, performance and efficiency at a glance. The graphical nature of the method furthermore allows for a visual verification of both the evaluation process and results \[3,4], making it more transparent than arithmetic or numerical methods.
57 changes: 57 additions & 0 deletions gitbook/SUMMARY.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,57 @@
# Table of contents

* [Interactive 2D Graphic Statics (IGS2)](README.md)

## quick start

* [Quick install](quick-start/quick-install.md)
* [Dev install](quick-start/installation.md)
* [Workflow + UI](quick-start/workflow-+-ui.md)
* [Tutorial](quick-start/tutorial.md)

## theoretical background

* [Introduction](theoretical-background/0.-motivation.md)
* [Algebraic graph statics (AGS)](theoretical-background/algebraic-graph-statics.md)
* [Interactive AGS](theoretical-background/interactive-ags.md)
* [Constraints in IGS](theoretical-background/constraints-in-igs.md)

## documentation

* [Known Issues](documentation/known-issues.md)
* [Command API](documentation/command-api.md)
* [User Manual](documentation/user-manual/README.md)
* [0. Initialisation](documentation/user-manual/0.-initialisation.md)
* [1. form graph](documentation/user-manual/1.-form-graph.md)
* [2. force graph](documentation/user-manual/2.-force-graph.md)
* [3. assigning forces](documentation/user-manual/3.-assigning-forces.md)
* [4. solve equilibrium matrix](documentation/user-manual/4.-solve-equilibrium-matrix.md)
* [5. update force graph](documentation/user-manual/5.-update-force-graph.md)
* [6. reciprocal diagrams](documentation/user-manual/6..md)
* [Settings](documentation/user-manual/settings.md)
* [Extensions](documentation/user-manual/extensions.md)

## Examples

* [Triangulated Truss](examples/4.-triangulated-truss.md)
* [Funicular arch](examples/2..md)
* [Constant-force truss](examples/wip-gable-truss.md)
* [Maillart truss form-finding](examples/2.-maillart-truss.md)
* [Manual Force Control](examples/manual-force-control.md)
* [Arch pointed load](examples/arch-pointed-load.md)
* [Staircase](examples/staircase.md)
* [Suspended Bridge](examples/suspended-bridge.md)

## Additional Information

* [Background](additional-information/background.md)
* [Releases](additional-information/releases.md)
* [Workshops](additional-information/workshops.md)
* [Legal terms](additional-information/legal-terms.md)
* [FAQ](additional-information/faq.md)

## links

* [compas\_ags code](links/compas\_ags-code.md)
* [compas\_ags releases](links/compas\_ags-releases.md)
* [compas\_ags issues](links/compas\_ags-issues.md)
5 changes: 5 additions & 0 deletions gitbook/additional-information/background.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,5 @@
# Background

IGS is an implementation of Algebraic Graphic Statics (AGS) developed by the Block Reseach Group. More background is available in the research page:

{% embed url="https://block.arch.ethz.ch/brg/research/algebraic-graph-statics" %}
2 changes: 2 additions & 0 deletions gitbook/additional-information/faq.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,2 @@
# FAQ

77 changes: 77 additions & 0 deletions gitbook/additional-information/legal-terms.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,77 @@
# Legal terms

### 1. Definition of the Software

Interactive Graphic Statics (IGS) is a software package for performing 2D graphic statics using the Algebraic Graphic Statics (AGS). IGS was developed by the [Block Research Group](https://block.arch.ethz.ch/).

The “Software” shall be considered the compiled IGS plugin to the [Rhinoceros®](https://www.rhino3d.com/) software of Robert McNeel and Associates, Seattle, and the corresponding documentation to IGS. For the avoidance of doubt, Rhinoceros® shall not be considered part of IGS and/or the Software and it is the LICENSEE’s responsibility to obtain the necessary Rhinoceros® license. Source code shall not be considered part of the Software.

### 2. License of ETH Zurich

ETH Zurich hereby grants a single, non-exclusive, world-wide, royalty-free license to use Software subject to all the terms and conditions of this Agreement to the LICENSEE.

### 3. The Scope of the License

#### a. Use

The Software may be used for commercial and/or non-commercial purposes. The LICENSEE retains all rights to results from such use. The LICENSEE and/or its employees may use the Software by himself/themselves, only.

#### b. Reproduction

Reproduction is prohibited except for the provisions of the applicable law (article 21 URG \[Bundesgesetz über das Urheberrecht, SR 231.1]).

#### c. Modification

Neither modification, combination with other commercial applications or other preparation of derivative works of the Software, nor reverse engineering, decompilation, disassembly or other reduction of any portion of the Software is permitted except for the provisions of the applicable law (article 21 URG \[Bundesgesetz über das Urheberrecht, SR 231.1]).

#### d. Distribution

Assignment to a third party is prohibited.

### 4. Obligations of LICENSEE

### a. Use

Any report or publication of results obtained by the Software has to be acknowledged by citing the publication listed under article 1.

### 5. Intellectual property and other rights

Ownership and intellectual property rights in and to the Software shall remain in ETH Zurich.

ETH Zurich reserves the right to withdraw distribution privileges from any group, individual, or organization for any reason.

### 6. Maintenance, support, upgrades or new releases

ETH Zurich has no obligation of maintenance, support, upgrades or new releases and disclaims all costs associated with serving, repair or correction.

### 7. Warranty

The Software is provided “as is”. ETH Zurich does not make any warranty of any kind. The LICENSEE assumes the entire risk as to the results and performance of the SOFTWARE. Disclaimed warranties include for example:

* warranty of merchantability, satisfactory quality and fitness for a particular purpose
* warranty of accuracy of results, of the quality and performance of the Software
* warranty of noninfringement of the intellectual property rights of third parties.

The tool was developed to support the user in the form finding process of vaulted compression structures in the early design phase. It is obvious that prior to any realization of structures based on designs obtained with RV2, a detailed structural analysis is necessary.

### 8. Liability

ETH Zurich disclaims all liabilities. ETH Zurich shall not have any liability for any direct or indirect damage except for the provisions of the applicable law (article 100 OR \[Schweizerisches Obligationenrecht]).

### 9. Termination

In the case of fundamental breach through the LICENSEE, this Agreement may be terminated by ETH Zurich at any time. On termination all copies of the Software have to be destroyed.

### 10. Severability

If any provisions of this Agreement will become invalid or unenforceable, such invalidity or enforceability shall not affect the other provisions of Agreement which shall remain in full force and effect provided that the basic intent of the parties is preserved. The parties will in good faith negotiate substitute provisions to replace invalid or unenforceable provisions which reflect the original intentions of the parties as closely as possible and maintain the economic balance between the parties.

### 11. Applicable law

This Agreement as well as any and all matters arising out of it shall exclusively be governed by and interpreted in accordance with the laws of Switzerland, excluding its principles of conflict of laws.

### 12. Jurisdiction

If any dispute, controversy or difference arises between the Parties hereto in connection with or out of this Agreement, the parties hereto shall first attempt to settle it amicably. Should settlement not be achieved, the Courts of Zurich-City shall have exclusive jurisdiction.

**By using IGS, you indicate your acceptance of these legal terms.**
5 changes: 5 additions & 0 deletions gitbook/additional-information/releases.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,5 @@
# Releases

The latest releases of IGS can be found in the GitHub repository release page:

{% embed url="https://github.com/BlockResearchGroup/compas-IGS/releases" %}
7 changes: 7 additions & 0 deletions gitbook/additional-information/workshops.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,7 @@
# Workshops

IGS is one of the tools used for the "Computational Structural Design I - 2021" course at ETH Zürich. The link for the course notes is provided below:

{% embed url="https://blockresearchgroup.gitbook.io/csd1-2021" %}

More workshops coming soon!
5 changes: 5 additions & 0 deletions gitbook/documentation/command-api.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,5 @@
# Command API

The list with all commands possible in IGS is presented below:

![](<../.gitbook/assets/image (193).png>)
17 changes: 17 additions & 0 deletions gitbook/documentation/known-issues.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,17 @@
# Known Issues

## I can not initiate IGS

If you face problems to initiate IGS and receives the following message:

`Unknown command: 'IGS__init'`

Please try running the command `EditPythonScript` as this command activates the Python environment in Rhino.

Then close the pop-up window and try to initialise the plug-in again.

## My form/force diagram disappear

This is usually related to the fact that you initiated IGS in a different window or even that you initiated IGS before opening the file with the lines to work on.

Please close Rhino and start it again by initialising the plug-in.
7 changes: 7 additions & 0 deletions gitbook/documentation/user-manual/0.-initialisation.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,7 @@
# 0. Initialisation

For working with IGS in a Rhino session the plug-in must be initialised. The button Initialise IGS should always be pressed first to activate the commands.&#x20;

![](<../../.gitbook/assets/image (65).png>)

After pressing this button the following welcome window displays where the users are asked to accept our [Terms & Conditions](../../additional-information/legal-terms.md).
34 changes: 34 additions & 0 deletions gitbook/documentation/user-manual/1.-form-graph.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,34 @@
# 1. form graph

The input form diagram representing the structure should be a **planar graph** with leaf edges representing the boundary conditions (loads and supports).

This user manual gives a more detailed explanation of the [tutorial](../../quick-start/tutorial.md) developed to the single panel truss example represented in the image below:

![](<../../.gitbook/assets/image (39).png>)

## The input sketch

The structural problem above should be translated to **straight segments** in Rhino. The following shows the "sketch" that is necessary to create the form diagram.

![](../../.gitbook/assets/ags\_sequence-01.jpg)

As mentioned above, edges should be added to represent loads and boundary conditions.

## Form graph

![](<../../.gitbook/assets/image (3).png>)

Once this set of lines is inserted in IGS the leaf edges are lighlighted in green and internal edges are black.

A few rules should be observed to create this form graph. The graph should not contain overlaps, and it should not containt 2-valent nodes, as in the figure below:

![Highlight on invalid inputs for the form graph](<../../.gitbook/assets/image (100).png>)

## Directed form graph

![](../../.gitbook/assets/ags\_sequence-03.jpg)

Inside IGS, this graph is interpreted as a directed graph described by the matrix **C** defined below:

![](<../../.gitbook/assets/image (19).png>)

41 changes: 41 additions & 0 deletions gitbook/documentation/user-manual/2.-force-graph.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,41 @@
# 2. force graph

The form graph has a dual graph associated to it. This dual graph is defined below, and after the equilibrium is computed this dual graph transforms in the force diagram of the problem.

## Dual graph

The dual graph of the single panel truss is depicted below. It is created by following the spaces of the form diagram.&#x20;

![](../../.gitbook/assets/ags\_sequence-04.jpg)

This topology is also described by a connectivity matrix **C\*** defined below:

![](<../../.gitbook/assets/image (155).png>)

## Dual relationships

The following immage shows the form and the dual diagrams side by side. Both diagrams have the same **number of edges.**

![](<../../.gitbook/assets/image (116).png>)

The **faces** of the **force diagram** are related to **internal vertices** in the **form diagram**

![](../../.gitbook/assets/ags\_sequence-06.jpg)

With such relations, the equilibrium of each node of the form diagram is related to a **closed polygon in the force diagram**. The following images show these relation for the internal nodes of the form diagram:

![](../../.gitbook/assets/ags\_sequence-08.jpg)

![](../../.gitbook/assets/ags\_sequence-09.jpg)

![](../../.gitbook/assets/ags\_sequence-10.jpg)

![](../../.gitbook/assets/ags\_sequence-11.jpg)

![](../../.gitbook/assets/ags\_sequence-12.jpg)

## Diagram orientation

As obeserved above, the dual diagram will generate edges that are perpendicular to the original edge sin the form diagram. However, up to a rotation of 90˚ this relationship can be changed, and how instead of perpendicular the edges in equilibrium will be parallel.

![](../../.gitbook/assets/ags\_sequence-13.jpg)
27 changes: 27 additions & 0 deletions gitbook/documentation/user-manual/3.-assigning-forces.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,27 @@
# 3. assigning forces

## Independent Edges

The forces can only be freely assigned to certain number of edges in a given form diagram. The number of edges that can be freely loaded corresponds to the number of independent states of self-stress _k_ defined in Van Mele et al. (2014). In a graph the states of self stress are associated with the geometry by the following equation:

$$
k - t =m-2n_i
$$

where $$t$$ is the number of inextensibles mechanisms, $$m$$ is the number of edges in the form graph and $$n_i$$ is the number of internal vertices of the form diagram. For all the examples in this tutorial no inextensibles mechanisms exist $$t=0$$ , such that the number of independent edges can be computed simply by:

$$
k =m-2n_i
$$

In the examples below we compute the number of independent edges (or DOF) in the form diagrams. The edges highlighted in purple represent a possible selection of the independent/loaded edges. Note that any combination of edges (including internal edges) can be selected as independent in these problems, however, it is more convenient to select the applied loads as independent edges. Based on the number of independent edges in a pattern we can divide the structures usually studied with IGS in three types:

![](<../../.gitbook/assets/image (35).png>)

IGS checks the required number of independent edges via the button `Check DOF`.&#x20;

We will be interested specially in structures of type A (non-funicular) and C (funicular) which can be asociated with the figure below:

![](<../../.gitbook/assets/image (184).png>)

with the definition of the independent edges the equilibrium can be solved in the next step.
13 changes: 13 additions & 0 deletions gitbook/documentation/user-manual/4.-solve-equilibrium-matrix.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,13 @@
# 4. solve equilibrium matrix

## Equilibrium through independent edges

The equations of equilibrium can be rearanged such that the equilibrium matrix **A** is defined as explained in the following chart:

![](<../../.gitbook/assets/image (13).png>)

Where **q** represent the force densities in the edges of the form diagram. With the definition of the equilibrium matrix the matrix A can be sliced and the forces in the dependent edges are calculated based on the forces assigned to the independent ones.

![](<../../.gitbook/assets/image (75).png>)

With such operations the new coordinates of the force diagram **x\***, **y\*** are computed. The update in the force graph is explained in the following section.
5 changes: 5 additions & 0 deletions gitbook/documentation/user-manual/5.-update-force-graph.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,5 @@
# 5. update force graph

The new coordinates of the force diagram computed through the [previous step](5.-update-force-graph.md) are then assigned to the repective nodes of the dual force graph [created in step ](2.-force-graph.md)2. As a result, the topology created is modified and both diagrams are [reciprocal](6..md).

![](../../.gitbook/assets/ags\_sequence-15\_reciprocation.gif)
9 changes: 9 additions & 0 deletions gitbook/documentation/user-manual/6..md
Original file line number Diff line number Diff line change
@@ -0,0 +1,9 @@
# 6. reciprocal diagrams

Reciprocal diagrams respect the following:

* All corresponding edges in form and force diagram are parallel.
* The length of the edges in the force diagram correspond to the magnitude of the forces in the form diagram.&#x20;
* The nodes of the form diagram are represented by closed polygons in the force diagram.

![](<../../.gitbook/assets/image (178).png>)
3 changes: 3 additions & 0 deletions gitbook/documentation/user-manual/README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,3 @@
# User Manual

The User Manual goes through the steps of IGS in depth explaining what's happening in the backgroud of the engine at each step.&#x20;
8 changes: 8 additions & 0 deletions gitbook/documentation/user-manual/extensions.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,8 @@
# Extensions

Future extensions of IGS will include:

* Optimisation features
* Additional functions and visualisation setttings

If you wish to contribute look at our [GitHub](https://github.com/BlockResearchGroup/compas-IGS) page.
33 changes: 33 additions & 0 deletions gitbook/documentation/user-manual/settings.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,33 @@
# Settings

The following Settings can be modified in IGS, this menu is activated by the button `Settings` in the toolbar.

![](<../../.gitbook/assets/image (66).png>)

## General settings

The general setings can be modified:

* **autoupdate:** It updates form and force diagrams automatically after a modification is imposed in one of them. The default value is off.
* **bi-directional:** It activates the module to perform modification on both diagrams after constraints are applied.
* **max\_deviation:** Sets the maximum deviation allowed by the program. If the angle deviations are higher than this parameter warnings will show in the screen.



## Form display settings

The display settings can be modified for the form diagram, such as:

* &#x20;**colors:** the default colors used can me modified by the user.
* **show:** a series of addititonal visualisation settings can be turned on or off by the user. Options include showing thicker pipes on the edges, displaying edge/vertex labels, etc.&#x20;
* **scale of force-pipes:** The scale of the force pipes can be set directly on this FormObject display setting.



## Force display settings

The display settings can be modified for the force diagram, such as:

* &#x20;**colors:** the default colors used can me modified by the user.
* **show:** a series of addititonal visualisation settings can be turned on or off by the user. Options such as displaying edge/vertex labels, etc.&#x20;
* **rotate:** The force diagram can be rotated of 90 degrees, such that reciprocal edges are perpendicular instead of parallel.
Loading

0 comments on commit c6ac635

Please sign in to comment.