Preview Rays

Utiliser Preview Rays dans BIMO pour Revit afin de visualiser les rayons solaires non obstrués et valider les réglages de Solar Exposure.

Preview Rays crée une prévisualisation statique des rayons d’ensoleillement direct pour les occurrences de famille sélectionnées dans la vue 3D active. Pour chaque instant échantillonné, la commande contrôle l’ouverture virtuelle et la géométrie du modèle, puis dessine uniquement les rayons qui atteignent le point de calcul sans obstacle.

Disponibilité actuelle : Preview Rays est enregistré dans la bibliothèque BIMO et inclus sous BIMO > Analyze dans le schéma de ruban par défaut, mais il est masqué par défaut et contrôlé par la configuration du plan ou de l’espace de travail. La matrice tarifaire actuelle n’associe pas la commande à un niveau précis ; cette page ne garantit donc pas un accès PRIMO, OPTIMO ou ULTIMO. Si la commande est absente, vérifiez la configuration du ruban et des droits de l’espace de travail ou contactez support@bimo.tools.

Des builds BIMO sont disponibles pour Revit 2021–2027 et le code de Preview Rays ne contient aucune restriction propre à une version de Revit.

Quand l’utiliser

Utilisez Preview Rays pour :

  • voir les directions d’ensoleillement direct disponibles pour une fenêtre, un panneau ou une autre occurrence de famille ;

  • comprendre quels instants échantillonnés traversent une ouverture virtuelle sans obstacle ;

  • vérifier l’influence des murs, planchers, toitures, plafonds, Masses et Generic Models sur un point de calcul ;

  • comparer visuellement les orientations de familles ou de façades avant d’exécuter Solar Exposure.

Preview Rays ne constitue pas un calcul réglementaire. Il s’agit d’un instantané statique du modèle solaire simplifié de BIMO, et non d’une visualisation dynamique du Sun Path de Revit.

Conditions avant l’exécution

  • Ouvrez un projet Revit. Les documents de famille ne sont pas pris en charge.

  • Activez une vue 3D. La commande ne fonctionne pas dans les plans, coupes, élévations, feuilles ou nomenclatures.

  • Configurez la visibilité, la section box et les modèles liés dans la vue 3D active tels qu’ils doivent participer aux contrôles d’obstruction.

  • Préparez une ou plusieurs occurrences de famille possédant un emplacement par point ou par courbe pris en charge.

  • Vérifiez le True North de l’emplacement actif du projet.

  • Contrôlez les heures, le jour, la latitude, le pas d’échantillonnage et les dimensions de prévisualisation.

Limitation actuelle du formulaire : Preview Rays partage le modèle de réglages Daylight Measurement. Son validateur exige donc toujours la présence d’un Curtain Wall Panel dans le projet et contrôle un paramètre texte modifiable, Comments par défaut, bien que Preview Rays n’écrive jamais ce paramètre. Si le formulaire refuse le paramètre de résultat, ajoutez ou sélectionnez un paramètre approprié de Curtain Wall Panels ou contactez le support.

Sélectionner les occurrences

Présélectionnez des Family Instances compatibles puis lancez Preview Rays. Les éléments incompatibles de la sélection actuelle sont ignorés. Si aucune occurrence compatible n’est sélectionnée, Revit affiche Pick family instances ; choisissez les éléments puis terminez avec Finish.

La commande accepte les FamilyInstance sans filtre supplémentaire de catégorie. Toutefois, le simple fait d’être une occurrence de famille ne garantit pas le traitement : la commande exige également une Facing Orientation valide et un type de localisation pris en charge.

Point de calcul

Preview Rays contrôle un point pour chaque occurrence sélectionnée.

Type d’occurrence

Point de calcul initial

Curtain Wall Panel

Origine de la transformation du panneau plus Offset Upward.

Occurrence localisée par point et hébergée par un Wall

Point de localisation décalé de la moitié de l’épaisseur du mur dans la direction de l’occurrence, plus Offset Upward.

Autre occurrence localisée par point

Point de localisation sans décalage vertical.

Occurrence localisée par courbe

Milieu de la courbe sans décalage vertical.

Autre type de localisation

Non pris en charge ; la commande échoue et annule le résultat de toute l’exécution.

Après avoir trouvé le point, la commande le déplace vers l’arrière par rapport à la Facing Orientation d’une distance égale à Window Depth. Pour les panneaux d’un Curtain System courbe, l’orientation peut être inversée au moyen de la géométrie de Mass et de CurveHostDistanceTolerance.

Réglages de la commande

La commande principale ouvre les réglages partagés Daylight Measurement. Le tableau indique les valeurs par défaut et validations confirmées dans le code.

Réglage

Valeur par défaut

Plage valide

Effet sur Preview Rays

Latitude

55

0-90

Utilisée par BIMO pour calculer les vecteurs solaires. Une latitude négative est refusée.

Sunrise Hour

7

4-20

Première heure entière de la plage ; elle est incluse.

Sunset Hour

17

4-20

Fin de la plage ; cette heure est exclue.

Day Of Year

112

1-365

Définit la déclinaison solaire. Le jour 112 correspond approximativement au 22 avril d’une année non bissextile.

Calculation Result Parameter

Comments

Paramètre texte modifiable sur Curtain Wall Panels

Non utilisé comme sortie de Preview Rays, mais toujours validé par le formulaire partagé.

Minute Step

5

1-15

Intervalle entre les directions testées. Un pas plus faible crée davantage de rayons et augmente le temps de traitement.

Window Depth (mm)

0

Aucune plage explicite

Définit la profondeur de l’ouverture virtuelle et déplace le point de calcul.

Window Width (mm)

0

Aucune plage explicite

Définit la largeur de l’ouverture virtuelle. Avec une valeur non positive, le contrôle latéral interne utilise 1000 mm, mais aucun contour d’ouverture n’est dessiné.

Offset Upward (mm)

500

Aucune plage explicite

Appliqué uniquement aux Curtain Wall Panels et aux occurrences par point hébergées par un Wall.

Minimum Time Period (minutes)

60

1-901

Non utilisé par Preview Rays ; il s’agit d’un réglage de Solar Exposure.

Discontinuous Insolation Label

Intermittent précédé d’un espace

Texte

Non utilisé par Preview Rays.

Not Enough Time Label

- No continuous hour précédé d’un espace

Texte

Non utilisé par Preview Rays.

Preview Rays Height (mm)

100000

Aucune plage explicite

Détermine la longueur calculée des rayons à partir de l’altitude solaire.

Preview Rays Maximum Length (mm)

500000

Aucune plage explicite

Limite la longueur de chaque rayon dessiné.

CurveHostDistanceTolerance

400

Aucune plage explicite

Tolérance utilisée pour déterminer l’orientation d’un panneau sur une face courbe de Mass.

Sunrise Hour et Sunset Hour sont validés indépendamment. Le formulaire ne vérifie pas que l’heure de fin est postérieure à l’heure de début. Si elle est égale ou antérieure, aucune direction solaire n’est générée et le DirectShape peut contenir uniquement la croix du point de calcul et, avec des réglages appropriés, le contour de l’ouverture.

Pour un échantillonnage régulier, utilisez un pas qui divise 60, par exemple 1, 2, 3, 4, 5, 6, 10, 12 ou 15. La profondeur, la largeur, le décalage, la hauteur, la longueur maximale et la tolérance n’ont aucune validation explicite ; utilisez des valeurs cohérentes et non négatives et testez d’abord une seule occurrence.

Heures propres à chaque occurrence

Toute occurrence sélectionnée peut remplacer les heures partagées lorsqu’elle possède les paramètres entiers suivants :

Paramètre de l’occurrence

Comportement

Use BIMO Settings

Absent ou supérieur à 0 : utiliser les réglages de la commande. 0 ou valeur négative : lire les heures propres à l’occurrence ci-dessous.

Sunrise Hour

Première heure propre à l’occurrence lorsque Use BIMO Settings n’est pas positif.

Sunset Hour

Heure de fin propre à l’occurrence lorsque Use BIMO Settings n’est pas positif.

Pour une plage propre à l’occurrence, l’heure de fin doit être postérieure à l’heure de début et les deux valeurs doivent être comprises entre 1 et 23. Des heures manquantes ou non valides provoquent une erreur et annulent toute l’exécution. La latitude, le jour, le pas et tous les autres réglages proviennent toujours du preset BIMO sélectionné.

Procédure pas à pas

  1. Activez la vue 3D requise et vérifiez sa visibilité et sa section box.

  2. Présélectionnez les occurrences de famille ou laissez la sélection vide.

  3. Lancez Preview Rays si la commande est disponible dans votre ruban.

  4. Vérifiez le preset et les réglages Daylight Measurement, puis cliquez sur OK.

  5. Si Revit affiche Pick family instances, choisissez les éléments puis Finish.

  6. Si l’indicateur Create rays preview apparaît, attendez la fin ou annulez le traitement.

  7. Examinez dans la vue 3D les rayons générés, les croix des points de calcul et les contours d’ouverture virtuelle.

  8. Après le contrôle, utilisez Undo dans Revit ou supprimez manuellement la géométrie générée lorsqu’elle n’est plus nécessaire.

Éléments créés

La commande crée un DirectShape persistant de catégorie Lines pour chaque occurrence sélectionnée. Il peut contenir :

  • une ligne pour chaque direction solaire non bloquée par l’ouverture virtuelle ou la géométrie du modèle ;

  • une croix de 1000 × 1000 mm au point de calcul ;

  • un contour à trois côtés de l’ouverture virtuelle lorsque la Facing Orientation est horizontale et que la largeur et la profondeur sont positives.

Le contrôle d’obstruction comprend Generic Models, Masses, Floors, Roofs, Ceilings et Walls, y compris les références trouvées dans les modèles Revit liés. Les Curtain Wall Panels ne font pas partie de ce filtre. Preview Rays utilise la géométrie et la visibilité actuelles de la vue 3D active ; contrairement à Solar Exposure, il ne masque pas temporairement des catégories avant le lancer de rayons.

Les rayons ne commencent volontairement pas à la croix. Les échantillons aux heures entières commencent à 2000 mm et se terminent à 100 % de l’étendue calculée ; les échantillons à :30 commencent à 2250 mm et se terminent à 95 % ; tous les autres commencent à 2500 mm et se terminent à 90 %. L’étendue calculée dépend de l’altitude solaire et est limitée par Preview Rays Maximum Length.

Lorsqu’un rayon est absent, cette direction a été rejetée par l’ouverture virtuelle ou par un obstacle détecté. Les rayons bloqués ne sont pas représentés par une autre couleur ni une géométrie distincte.

Presets, variants et raccourcis clavier

Preview Rays prend en charge les presets BIMO pour les réglages partagés Daylight Measurement. Trois variants sont générés :

  • la commande principale ouvre la fenêtre de réglages ;

  • Variant #1, Variant #2 et Variant #3 peuvent exécuter les presets affectés et ignorer la fenêtre lorsque leurs réglages sont valides ;

  • chaque variant est un élément distinct du ruban pouvant recevoir un raccourci clavier Revit.

Les variants possèdent les mêmes restrictions de visibilité par plan, de document de projet et de vue 3D active que la commande principale. Consultez Presets and Variants.

Exemples

Curtain Wall Panel

Sélectionnez un panneau de façade, réglez Offset Upward pour placer la croix au point de contrôle requis et exécutez la commande. La prévisualisation montre uniquement les directions d’ensoleillement direct disponibles pour ce point.

Fenêtre hébergée par un mur

Pour une occurrence hébergée par un Wall, définissez la profondeur et la largeur de l’ouverture virtuelle. La commande tient compte de la moitié de l’épaisseur du mur, du décalage vertical et des limites latérales virtuelles de l’ouverture.

Croix sans rayons

Si seule une croix est créée, vérifiez l’ordre des heures, l’orientation de l’occurrence, le True North, la section box, la visibilité des obstacles et les dimensions de l’ouverture virtuelle. Cela peut être un résultat valide lorsque toutes les directions calculées sont bloquées.

Modifications du modèle et nettoyage

  • Une exécution réussie ajoute un DirectShape par occurrence dans une seule transaction Revit nommée Create rays preview.

  • La commande ne remplace pas une ancienne prévisualisation. Les exécutions successives ajoutent de nouveaux éléments pouvant se superposer.

  • Preview Rays n’écrit ni Comments ni aucun autre paramètre de résultat de Solar Exposure.

  • L’annulation via l’indicateur de progression ou une erreur sur une occurrence annule la transaction partagée.

  • Immédiatement après l’exécution, Undo dans Revit supprime tous les éléments générés en une seule étape.

  • Ultérieurement, sélectionnez les DirectShapes générés dans la vue 3D et supprimez-les manuellement. Aucune commande BIMO publiée de nettoyage dédiée à Preview Rays n’est confirmée dans le ruban actuel.

Vérifiez soigneusement la sélection avant une suppression manuelle afin de ne pas supprimer d’autres éléments de catégorie Lines.

Limites

  • Le modèle solaire utilise une latitude, un jour et des limites horaires entières saisis manuellement. Il ne lit pas les Sun Settings de Revit, la longitude, le fuseau horaire, l’heure d’été ou les données météorologiques.

  • La latitude est limitée à 0-90 ; le formulaire actuel ne prend pas en charge les latitudes négatives de l’hémisphère sud.

  • Un seul point de calcul est contrôlé, et non la surface ou le volume de l’occurrence.

  • Preview Rays montre uniquement les rayons non obstrués et n’indique pas pourquoi un autre rayon a été bloqué.

  • Le résultat dépend de la Facing Orientation, du True North, de la vue 3D active, de sa section box et de sa visibilité, des catégories d’obstacles prises en charge et de la géométrie des modèles liés.

  • Les Curtain Wall Panels ne jouent pas le rôle d’obstacles dans le filtre d’intersection actuel.

  • Offset Upward n’est pas appliqué de façon uniforme à tous les types de localisation.

  • Avec une largeur de fenêtre non positive, le contrôle interne utilise 1000 mm alors qu’aucun contour d’ouverture n’est dessiné.

  • Les dimensions de prévisualisation n’ont aucune validation explicite. Des valeurs trop petites, négatives ou incohérentes peuvent produire une géométrie trompeuse ou une erreur Revit.

  • La géométrie générée est statique : elle ne se met pas à jour après une modification du modèle, de la vue, du True North ou des réglages. Supprimez l’ancienne prévisualisation puis relancez la commande.

Erreurs et dépannage

Problème

Vérification

Preview Rays est absent du ruban

La commande est masquée dans le schéma par défaut et contrôlée par la configuration du plan ou de l’espace de travail. La matrice actuelle ne confirme aucun niveau précis.

BIMO demande une vue 3D

Activez une vue 3D et relancez la commande.

Le formulaire refuse Comments ou un autre paramètre

Le validateur partagé exige actuellement un Curtain Wall Panel avec un paramètre texte modifiable, même si Preview Rays ne l’écrit pas.

Revit affiche Pick family instances

La sélection actuelle ne contient aucune Family Instance compatible. Sélectionnez-les manuellement puis cliquez sur Finish.

Une croix est créée mais aucun rayon n’apparaît

Vérifiez que l’heure de fin est postérieure à l’heure de début, que l’occurrence est orientée correctement, que le True North est correct et que l’ouverture virtuelle et la géométrie visible ne bloquent pas toutes les directions.

Un rayon attendu comme bloqué est absent

C’est le comportement normal : la commande dessine uniquement les rayons non obstrués.

Les rayons pointent dans la mauvaise direction

Vérifiez la Facing Orientation, l’état de retournement de la famille, le True North et la tolérance de face courbe de Mass.

Une erreur mentionne Sunrise Hour et Sunset Hour

L’occurrence possède Use BIMO Settings égal ou inférieur à 0, mais ses heures propres sont absentes, hors de 1-23 ou dans un ordre non valide.

Toute l’exécution est annulée à cause d’un élément

Une occurrence possède un type de localisation non pris en charge, une orientation non valide ou une géométrie que Revit ne peut pas créer. Réessayez avec les occurrences une par une.

Les prévisualisations se superposent ou semblent dupliquées

La commande ne nettoie pas les anciens DirectShapes. Utilisez Undo après l’exécution ou supprimez manuellement l’ancienne géométrie.

Les rayons ne se mettent pas à jour après une modification du modèle

La prévisualisation est statique. Supprimez les anciens DirectShapes puis relancez la commande.

Le paramètre de résultat n’a pas changé

Preview Rays n’écrit pas de paramètres. Pour calculer et écrire des minutes, utilisez Solar Exposure, sous réserve de sa disponibilité actuelle.

Pages associées

An error has occurred. This app may no longer respond until reloaded. Reload 🗙