You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: docs/guide/parameters.md
+37-3Lines changed: 37 additions & 3 deletions
Original file line number
Diff line number
Diff line change
@@ -1,10 +1,29 @@
1
1
# Parameters
2
2
3
3
4
+
5
+
6
+
### Parameter Types
7
+
8
+
Design Variables, or sometimes referred to as User Defined Variables, are those parameters that are crucial to the concept definition of the design. Often those parameters contain numerical inputs that are allowed to change during the design (and/or optimization). A parameter is a symbolic name often associated with a numerical value and which may be changed. Not all parameters are Design Variables but all Design Variables are parameters. Parameters could be constant. If this is the case, do not use sliders to define their values, but Set Numbers instead. Clearly label Design Variables.
9
+
10
+
11
+
12
+
#### Input Parameters
13
+
These are parameters that provide input values to a Grasshopper definition. Input parameters can be used to define the starting point for a design or to allow users to provide specific input values.
14
+
15
+
#### Output Parameters
16
+
These are parameters that provide output values from a Grasshopper definition. Output parameters can be used to display the results of a design or to provide data to other software applications.
17
+
18
+
19
+
20
+
21
+
### Parameter Naming Conventions
22
+
4
23
When naming design parameters in your Rhino Grasshopper scripts, it is important to use clear and descriptive names that accurately reflect the purpose of the parameter.
5
24
Using the following best practices, you can create more readable, understandable, and maintainable definitions in Rhino Grasshopper:
6
25
7
-
#### 1. Meaningful Mames
26
+
#### 1. Meaningful Names
8
27
Always use descriptive and meaningful names: Use names that describe the purpose or function of the parameter. Avoid using vague or generic names that do not provide enough information about the parameter's role in the definition.
9
28
10
29
2. Use consistent naming conventions: Use consistent naming conventions throughout your definition. This makes it easier to understand the relationships between different parameters and components.
@@ -21,11 +40,26 @@ Always use descriptive and meaningful names: Use names that describe the purpose
21
40
22
41
23
42
43
+
44
+
### Parameter Type Conventions
45
+
46
+
47
+
48
+
#### single
49
+
50
+
'''
51
+
(parameter)
52
+
'''
53
+
54
+
#### list
55
+
56
+
'''
57
+
[parameter]
58
+
'''
59
+
24
60
Design Variables and Parameters
25
61
26
62
27
-
Different types of parameters
28
-
Design Variables, or sometimes referred to as User Defined Variables, are those parameters that are crucial to the concept definition of the design. Often those parameters contain numerical inputs that are allowed to change during the design (and/or optimization). A parameter is a symbolic name often associated with a numerical value and which may be changed. Not all parameters are Design Variables but all Design Variables are parameters. Parameters could be constant. If this is the case, do not use sliders to define their values, but Set Numbers instead. Clearly label Design Variables.
Copy file name to clipboardExpand all lines: docs/index.md
+23Lines changed: 23 additions & 0 deletions
Original file line number
Diff line number
Diff line change
@@ -11,6 +11,16 @@
11
11
12
12
**Starling Egg is a Grasshopper template geared towards project collaboration.**
13
13
14
+
Starling Egg is a Grasshopper template that has been specifically designed for project collaboration. This template allows multiple designers to work together on a single Grasshopper definition, making it ideal for projects where a team-based approach is required.
15
+
16
+
One of the key features of Starling Egg is its ability to manage version control. With this template, each designer can work on a separate branch of the Grasshopper definition, making changes and testing new ideas without affecting the work of other team members. Once a design element has been finalized, it can be merged back into the main branch of the definition, ensuring that all team members are working with the latest version of the design.
17
+
18
+
Another important feature of Starling Egg is its ability to support communication and collaboration between team members. The template includes a range of tools for commenting on design elements, discussing design decisions, and sharing information with other team members. This makes it easier for team members to work together effectively, even if they are located in different parts of the world.
19
+
20
+
In addition, Starling Egg includes a range of components that can be used to create complex geometries, define materials and textures, and generate detailed reports and documentation. These components are designed to be flexible and adaptable, so that they can be easily customized to meet the specific needs of a design project.
21
+
22
+
Overall, Starling Egg is a powerful and flexible tool that can help design teams to work more efficiently and effectively. Whether you are working on a large-scale architectural project or a smaller design project, this template is sure to be a valuable asset in your design toolkit.
23
+
14
24
---
15
25
16
26
**Starling Egg** consists of a reference document and a Rhino + Grasshopper template.
@@ -21,6 +31,19 @@ The Grasshopper Template is a part of every Grasshopper project. It guides the w
Starling Associates has developed a powerful Rhino Grasshopper template system that can help designers streamline their workflow and improve the quality of their designs. This template system includes a set of pre-built Grasshopper components that can be easily customized and adapted to fit the specific needs of a design project.
36
+
37
+
The template system includes a variety of components that can be used to create complex geometries, apply materials and textures, define lighting and camera settings, and generate documentation and reports. The system is designed to be intuitive and easy to use, with a user-friendly interface that allows designers to quickly and easily navigate through the various components.
38
+
39
+
One of the key features of the Starling Associates template system is its focus on modularity and flexibility. The components can be easily combined and reconfigured to create new designs, and they can be adapted to work with different types of input data and design parameters.
40
+
41
+
Another important feature of the template system is its emphasis on sustainability and energy efficiency. The components include a range of tools and techniques for optimizing designs and reducing energy consumption, making it an ideal choice for architects, engineers, and designers who are committed to creating sustainable and environmentally-friendly designs.
42
+
43
+
Overall, the Rhino Grasshopper template system developed by Starling Associates is a powerful and versatile tool that can help designers to create high-quality, innovative designs more efficiently and effectively. Whether you are working on a small-scale project or a large-scale architectural design, this template system is sure to be a valuable asset in your design toolkit.
44
+
45
+
46
+
24
47
---
25
48
26
49
**Starling Egg** is an open-source project by [Starling Associates](https://www.starling.associates"Starling Associates website") and [Scape Agency](https://www.scape.agency"Scape Agency website").
Starling Egg is a Grasshopper template that has been specifically designed for project collaboration. To get up and running follow these instructions:
5
+
6
+
1.**Download** – Download the latest release of the Starling Egg template files from our repository.
7
+
8
+
9
+
10
+
11
+
12
+
The Starling Egg template can be downloaded from the Starling Associates website. Once you have downloaded the template, simply install it on your computer using the provided installer.
13
+
14
+
Open the Starling Egg template in Grasshopper: Once the template has been installed, open it in Grasshopper. You should see a range of components and tools that have been specifically designed for project collaboration.
15
+
16
+
Familiarize yourself with the interface: Take some time to explore the interface and get familiar with the different components and tools that are available. You'll find tools for version control, commenting, and sharing information with other team members.
17
+
18
+
Set up your team: Before you start working on a project, you'll need to set up your team. This can be done using the team management tools included in the template. You can add team members, assign roles, and set up permissions to ensure that everyone has the right level of access to the project.
19
+
20
+
Start collaborating: Once your team is set up, you can start collaborating on your project. Use the commenting tools to discuss design decisions, share information, and provide feedback. Use the version control tools to manage different branches of the Grasshopper definition, and merge changes back into the main branch once they have been finalized.
21
+
22
+
Customize the template to fit your needs: The Starling Egg template is designed to be flexible and adaptable, so you can customize it to fit the specific needs of your project. You can add new components, modify existing ones, and create your own tools and workflows.
23
+
24
+
By following these simple steps, you can start using the Starling Egg template to collaborate more effectively on your next design project. With its powerful set of tools and flexible interface, this template is sure to be a valuable asset in your design toolkit.
0 commit comments