ファミリ内のパラメータの値を計算するための式の使用方法の例を確認します。
詳細サンプル ファミリにはさまざまな種類の式のサンプルが含まれており、パラメータの値を計算したり、ファミリのジオメトリをコントロールするための式の使用方法が紹介されています。サンプル ファミリでは、よく使用される式タイプの構文も紹介されています。
詳細サンプル ファミリ(rac_advanced_sample_family.rfa)は、製品のインストール時に %ProgramFiles%\Autodesk\Autodesk Revit 2022¥Samples フォルダにインストールされます。 オンライン ユーザは、「サンプル ファミリ ファイル」ページからファイルをダウンロードすることもできます。
詳細サンプル ファミリは、プロジェクト内の窓の上に配置されたサン シェーディング装置です。ユーザは、日除けファミリと窓の関係を示すパラメータを設定します。式に基づいて、日除けのジオメトリが変更され窓にシェーディングが設定されます。次のイメージは、プロジェクト内の日除けファミリの 3D ビューと立面図ビューを表しています。
基本演算
これらの例では、式における基本的な演算関数を説明します。
| パラメータ | 式 |
|---|---|
Shadow_Length |
Mounting_Height-Window_Sill_Height |
Rel_Angle |
90º-Sun_Angle |
Max Louver Spacing |
Support_Length-(Support_Length*(Desired_Shading_Percent*0.01)) |
- Shadow_Length パラメータは、ファミリの取り付け高さから下枠の高さを引くことにより計算されます。
- 結果は、窓を完全に日除けするために、ルーバー システムに必要となる影の長さとなります。
- Rel_Angle パラメータは、定数 90 から太陽の角度を引いて計算されます。
後ほどこのパラメータは、影付けするのに必要な桁の長さ、つまり Shadow_Length パラメータによって設定される長さを三角関数を使用して計算する別の式で使用します。
- Max Louver Spacing は、支持材の長さと必要な影の量に基づいて計算されます。
- 式では、最初にパーセンテージを十進数の値に変換し、その後、この値に支持材の長さを掛けます。求められる値は、ルーバーで覆う必要のある影の量となります。
丸めと三角関数
支持材の長さは三角関数を使用して計算され、最も近いミリメートル(mm)に切り上げられます。
| パラメータ | 式 |
|---|---|
Support_Length |
roundup((Shadow_Length/1mm)*tan(Rel_Angle))*1mm |
- 必要な Support_Length は、プロジェクトの時期および場所位置に基づいて、Shadow_Length にシェーディング装置に対する太陽の相対角度の正接をかけて求められます。
これらの変数の条件により、窓を完全に覆うために必要な支持材の長さが変更されます。
- 丸め関数により、算出された値が最も近い mm に丸められます。丸め関数を使用する場合は、丸められる数値に単位を付けないようにします。
- サンプルの式では、最初に Shadow_Length パラメータを 1 mm で割ることでパラメータから長さの単位を取り除き、その後に計算を実行しています。
- 数値を最も近い mm に丸めた後に、1 mm をかけることで、数値に単位が戻されます。
条件文
他のパラメータの値を確認したり、それらの値に基づいた結果を返す場合には、式の中で条件文を使用することができます。詳細については、「計算式に条件文を使用する」を参照してください。例では、Support_Hanger パラメータは Yes/No パラメータとなっており、日除けのための追加の支持材の表示をコントロールするのに使用します。
| パラメータ | 式 |
|---|---|
Support_Hanger |
Support_Length>400mm |
Shade_Factor |
if(Desired_Shading_Percent<65,"Low",if(Desired_Shading_Percent<79,"Med",if(Desired_Shading_Percent<99,"High","Max."))) |
- Support_Length パラメータが 400 mm を超えると条件文が true となり、パラメータの値が「Yes」に設定され、追加の支持材が表示されます。
Yes/No パラメータを設定するのに式の中で条件文を使用するときは、true の場合の結果と false の場合の結果は暗黙的なものとなるため、式の構文内に記述する必要はありません。
- Shade_Factor パラメータは、ネストされた条件文を使用し、Low、Med.、High、Max の 4 つのうちのいずれかの結果を返します。
- この値に基づいて、Desired_Shading_Percent に対するチェックが行われ、結果がテキストで返されます。
- 後続のそれぞれの IF 文がチェックされます。条件が true でなければ、結果が true になるまで次の IF 文が評価されます。
配列の式
ファミリ内の配列は整数のパラメータを使用してコントロールできます。式を使用して配列をコントロールする場合、式には配列の値が常時 1 よりも大きくなるように構文を設定する必要があります(配列の値は常時 1 よりも大きくなる必要があります)。
| パラメータ | 式 |
|---|---|
Number of Supports |
(Length/Max_Support_Spacing)+1 |
Louver Number |
(Support_Length/Max Louver Spacing)+1 |
- Number of Supports パラメータは基本的な算術関数であり、間隔情報およびシェーディング要素の全体の長さに基づいて、必要な支持材の数を決定するのに使用されます。
- Louver Number は、支持材の長さとルーバーに必要な間隔に基づいて、日除けにルーバーを配置するための配列の値を作成します。
- 両方の式とも、配列の値を常時 2 以上にするために、追加の「+1」が含まれています。
- この場合、両方のパラメータとも整数パラメータと設定されているため、式には丸め関数を含める必要はありません。