FB_BA_ShdObjEntry

Der Funktionsbaustein FB_BA_ShdObjEntry dient zur Verwaltung aller Verschattungselemente einer Fassade, welche global in einer Liste von Verschattungselementen hinterlegt sind. Er soll die Eingabe der Elementinformationen - auch im Hinblick auf die Nutzung einer Visualisierung - erleichtern. Eine schematische Darstellung der Objekte mit Beschreibung der Koordinaten ist unter Verschattungskorrektur: Grundlagen und Definitionen gegeben.

Die Deklaration der Verschattungselemente erfolgt in den globalen Variablen:

VAR_GLOBAL
     arrShdObj : ARRAY[1..BA_Param.nSunPrt.nMaxShdObj] OF ST_BA_ShdObj;
END_VAR

Jedes einzelne Element aShdObj[1] bis aShdObj [nMaxShdObj] trägt die Informationen für jeweils ein Verschattungselement (ST_BA_ShdObj). Dies sind neben dem gewählten Verschattungstyp (Viereck oder Kugel) die jeweils dazugehörigen Koordinaten. Im Falle eines Vierecks sind es die Eckpunkte (fP1x, fP1y, fP1z), (fP2x, fP2y, fP2z), (fP3x, fP3y, fP3z) und (fP4x, fP4y, fP4z) und im Falle einer Kugel der Mittelpunkt (fMx, fMy, fMz) und der Radius fRads. Zusätzlich kann über die Eingänge nBegMth und nEndMth die Phase der Verschattung definiert werden, was bei Objekten, wie z.B. Bäume, die im Winter kein Laub tragen, wichtig ist.

Der Baustein greift dabei über die IN-OUT-Variable aShdObj direkt auf das Feld dieser Informationen zu.

Anmerkung: Die Tatsache, dass die Vierecks Koordinaten fP2x, fP2z, fP4x, fP4y, und fP4z Ausgangswerte sind, ergibt sich daraus, dass sie aus den Eingabeparametern gebildet werden:

fP2x = fP1x; fP2z = fP1z; fP4x = fP3x; fP4y = fP1y; fP4z = fP3z;

Das schränkt die Eingabe eines Vierecks so weit ein, dass die seitlichen Kanten senkrecht auf dem Boden stehen (fP2x = fP1x und fP4x = fP3x), dass das Viereck keine Neigung hat (fP2z = fP1z und fP4z = fP3z) und nur nach "oben" also in positive y-Richtung eine unterschiedliche Höhe haben kann (fP4y = fP1y).

Die Verwendung des Bausteines erfolgt in drei Schritten:

• Auslesen
• Ändern
• Schreiben

Auslesen

Mit dem Eintrag an nId wird das entsprechende Element aus der Liste, aShdObj[nId], ausgewählt. Eine steigende Flanke an bRd liest die Daten aus. Diese Werte werden den Ein- und Ausgangsvariablen des Bausteines zugewiesen. Es handelt sich hierbei um die Eingangswerte fP1x, fP1y, fP1z, fP2y, fP3x, fP3y, fP3z, fMx, fMy, fMz, fRads und dem Objekt-Enumerator eType und um die Ausgangswerte fP2x, fP2z, fP4x, fP4y und fP4z. Wichtig ist hierbei, dass im Schritt des Auslesens die Eingangswerte nicht überschrieben werden. So lassen sich alle Werte zunächst in einer Visualisierung anzeigen.

Ändern

In einem nächsten Programmschritt können dann die aufgeführten Eingabewerte verändert werden. Wenn am Eingang eType über den Wert "eObjectTypeTetragon" die Verwendung eines Vierecks vorgewählt ist, ergeben sich die Ausgangswerte fP2x, fP2z, fP4x, fP4y, und fP4z aus den eingegebenen Koordinaten des Vierecks, siehe oben.

Die eingegebenen Werte werden ständig auf Plausibilität überprüft. Der Ausgang bErr zeigt an, ob die Werte gültig sind (bErr=FALSE). Wenn der Wert ungültig ist, wird am Ausgang sErrDescr eine entsprechende Fehlermeldung ausgegeben.
Wird ein Viereck definiert, müssen lediglich die Eingänge fP1x, fP1y, fP1z, fP2y, fP3x, fP3y und fP3z beschrieben werden, die Eingänge fMx, fMy, fMz und fRads brauchen nicht verknüpft zu werden. Im Falle einer Kugeldefinition müssen nur fMx, fMy, fMz und fRads beschrieben werden und die Viereckkoordinaten können unverknüpft bleiben

Schreiben

Mit einer positiven Flanke an bWrt werden die parametrierten Daten in das Listenelement mit dem Index niId geschrieben, unabhängig davon, ob sie gültige Werte darstellen oder nicht. Daher ist innerhalb der Elementstruktur ST_BA_ShdObj ein Plausibilitätsbit bVld vorhanden, das genau diese Information an den Baustein FB_BA_ShdCorr weiterreicht und dort Fehlberechnungen vorbeugt.

Diese Vorgehensweise soll nur als Vorschlag angesehen werden. Es ist auch möglich, den Baustein ganz normal in einem Schritt zu parametrieren und die eingetragenen Werte mit einer steigenden Flanke an bWrt in das entsprechende Listenelement zu schreiben.

Eingänge

VAR_INPUT
  nId         : UDINT;
  bRd         : BOOL;
  bWrt        : BOOL;
  fP1x        : REAL;
  fP1y        : REAL;
  fP1z        : REAL;
  fP2y        : REAL;
  fP3x        : REAL;
  fP3y        : REAL;
  fP3z        : REAL;
  fMx         : REAL;
  fMy         : REAL;
  fMz         : REAL;
  fRads       : REAL;
  nBegMth     : UDINT;
  nEndMth     : UDINT;
  eType       : E_BA_ShdObjType;
END_VAR

Bemerkung zur Verschattungsperiode:

Die Monatseinträge dürfen nicht 0 und größer 12 sein, andernfalls sind alle Kombinationen möglich.
Beispiele:
Beginn=1, Ende=1: Verschattung im Januar.
Beginn=1, Ende=5: Verschattung von Anfang Januar bis Ende Mai.
Beginn=11, Ende=5: Verschattung von Anfang November bis Ende Mai (des folgenden Jahres).

/ Ein-/Ausgänge

VAR_IN_OUT
  aShdObj: ARRAY[1..BA_Param.nSunPrt_MaxShdObj] OF ST_BA_ShdObj;
END_VAR

Ausgänge

VAR_OUTPUT
  fP2x       : REAL;
  fP2z       : REAL;
  fP4x       : REAL;
  fP4y       : REAL;
  fP4z       : REAL;
  bErr       : BOOL;
  sErrDescr  : T_MAXSTRING;
END_VAR

Voraussetzungen