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 > Analyzedans 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 contactezsupport@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,Commentspar 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 |
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 |
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 |
|---|---|---|---|
|
|
| Utilisée par BIMO pour calculer les vecteurs solaires. Une latitude négative est refusée. |
|
|
| Première heure entière de la plage ; elle est incluse. |
|
|
| Fin de la plage ; cette heure est exclue. |
|
|
| Définit la déclinaison solaire. Le jour 112 correspond approximativement au 22 avril d’une année non bissextile. |
|
| Paramètre texte modifiable sur Curtain Wall Panels | Non utilisé comme sortie de Preview Rays, mais toujours validé par le formulaire partagé. |
|
|
| Intervalle entre les directions testées. Un pas plus faible crée davantage de rayons et augmente le temps de traitement. |
|
| Aucune plage explicite | Définit la profondeur de l’ouverture virtuelle et déplace le point de calcul. |
|
| 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é. |
|
| Aucune plage explicite | Appliqué uniquement aux Curtain Wall Panels et aux occurrences par point hébergées par un Wall. |
|
|
| Non utilisé par Preview Rays ; il s’agit d’un réglage de Solar Exposure. |
|
| Texte | Non utilisé par Preview Rays. |
|
| Texte | Non utilisé par Preview Rays. |
|
| Aucune plage explicite | Détermine la longueur calculée des rayons à partir de l’altitude solaire. |
|
| Aucune plage explicite | Limite la longueur de chaque rayon dessiné. |
|
| 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 |
|---|---|
| Absent ou supérieur à |
| Première heure propre à l’occurrence lorsque |
| Heure de fin propre à l’occurrence lorsque |
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
Activez la vue 3D requise et vérifiez sa visibilité et sa section box.
Présélectionnez les occurrences de famille ou laissez la sélection vide.
Lancez Preview Rays si la commande est disponible dans votre ruban.
Vérifiez le preset et les réglages
Daylight Measurement, puis cliquez sur OK.Si Revit affiche Pick family instances, choisissez les éléments puis Finish.
Si l’indicateur Create rays preview apparaît, attendez la fin ou annulez le traitement.
Examinez dans la vue 3D les rayons générés, les croix des points de calcul et les contours d’ouverture virtuelle.
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 Orientationest 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 #2etVariant #3peuvent 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
DirectShapepar occurrence dans une seule transaction Revit nomméeCreate 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
Commentsni 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 Upwardn’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 | 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 |
Une erreur mentionne | L’occurrence possède |
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. |