OPTIS Labs Tutorials 2013

Size: px

Start display at page:

Download "OPTIS Labs Tutorials 2013"

Priscilla Holland
6 years ago
Views:

1 OPTIS Labs Tutorials 2013

3 Table of Contents Virtual Human Vision Lab... 4 Doing Legibility and Visibility Analysis... 4 Automation Using Automation Creation of a VB script Creation of a Luminaire Library Creating and Running a Macro Driving Virtual Reality Lab Lesson 1: Preparing the Data Lesson 2: Configuring of Excel Lesson 3: Writing of the Macro Lesson 4: Running of the Macro Index... 35

VIRTUAL HUMAN VISION LAB Doing Legibility and Visibility Analysis 1. From Start menu, click All Programs, OPTIS, OPTIS Labs, Labs, Virtual Human Vision Lab. A window appears. 2. Click File, Open.

4 VIRTUAL HUMAN VISION LAB Doing Legibility and Visibility Analysis 1. From Start menu, click All Programs, OPTIS, OPTIS Labs, Labs, Virtual Human Vision Lab. A window appears. 2. Click File, Open... -Or- Click. 3. Copy and extract LAB_Tutorials_Legibility_Visibility.zip (../Common/LAB_Tutorials_Legibility_Visibility.zip) in a local directory. 4. Browse the Legibility-visibility.xmp file. 5. Click Tools, Vision parameters... A window appears. 6. In Eye adaptation group box, select Dynamic adaptation. 7. Click Update and Close. 8. Click Tools, Legibility/Visibility tools... A window appears. 9. To study the legibility, zoom on the S letter on the map. Page 4 of 35 OPTIS Labs Tutorials User Guide

5 10. From Letter luminance box, click to select a pixel in the S letter. Luminance value is around 7000 cd/m². 11. From Background luminance box, click to select a pixel in the background luminance near the edge of the S letter. Luminance value is around 6000 cd/m². Virtual Human Vision Lab Page 5 of 35

6 From Size of the critical detail, click to adjust both extreme points of the line on the map. 12. Click to display colorimetric data. DeltaE value is higher than 100. This defines a good legibility. Page 6 of 35 OPTIS Labs Tutorials User Guide

7 13. From Curve options group box, select Age. Here a 20 years old person would have around 92% relative visual performance in reading the bottom part of the S letter of the STOP panel under the special illumination conditions given in the simulation. 14. From Curve options group box, select Background Luminance. Here the relative visual performance dramatically drops when the background luminance is close to the letter luminance. Virtual Human Vision Lab Page 7 of 35

8 15. From Curve options group box, select Letter Luminance. 16. From Curve options group box, select Letter size. Here if the observer was twice as far from the panel, the relative visual performance would have been around 76% for a 20 years old person. 17. From Contrast, select Bakground luminance is constant and then Letter luminance is constant. Page 8 of 35 OPTIS Labs Tutorials User Guide

9 Here because the luminance values of the letter and the background are very close, the contrast does not change in both cases. 18. Select the Visibility tab. 19. In Previous adaptation luminance box, type the value already defined in the vision parameters window. For more details, you can view Using Vision Parameters. 20. From Background luminance box, click to select a pixel in the background. 21. From Target luminance box, click to select a pixel on the letter. Virtual Human Vision Lab Page 9 of 35

10 Information is the letter is visible or not is displayed in the Visibility state box. 22. Click Tools, Sources operations... A window appears. Page 10 of 35 OPTIS Labs Tutorials User Guide

11 23. Decrease the power of the display source to 30% of its original value. The delta luminance between the background and the target drops and the target becomes invisible. Virtual Human Vision Lab Page 11 of 35

12 A calculation is made to obtain the minimum delta between the background and the target for a given value of the background luminance. Page 12 of 35 OPTIS Labs Tutorials User Guide

AUTOMATION Using Automation OPTIS Labs license is required. Internet Explorer can be used as HTML editor. Microsoft Word is necessary for the Creation of a Luminaire Library.

13 AUTOMATION Using Automation OPTIS Labs license is required. Internet Explorer can be used as HTML editor. Microsoft Word is necessary for the Creation of a Luminaire Library. The user is going to generate a first macro from scratches opening a Virtual Photometric Lab viewer and extracting values from it. The script will be executed from a HTML document. Then a second script will be written using Microsoft Word to generate a library of Luminaire showing the luminaire's name and the polar curve. Creation of a VB script This tutorial shows how to write a Visual Basic script using a HTML document to: Open an Optis Virtual Photometric Lab Map Get the main values of the map (max, min,...) If needed, you can download the LAB_Tutorials_Automation_VBScript.zip (../Common/LAB_Tutorials_Automation_VBScript.zip) file. 1. First, open a new Notepad document. This text file will be used to generate a HTML document that will include the VB script. 2. Save the document as AutomationMacro1.html with the type All Files. Automation Page 13 of 35

14 3. Insert a VB script that includes a function. 4. The following submit input is going to be used to launch the function RunOptisLabs. Every time the user will click on the Process button, the function will be run. Page 14 of 35 OPTIS Labs Tutorials User Guide

15 Open the HTML file to observe the result: 5. The following command lines allow the access to a Virtual Photometric Lab object to open a map. 6. Then, to access the type of unit used with the map: UnitType.Value is the value of a parameter that is going to be used in the HTML part of the code to display the unit type. 7. To access the different information about the map: Automation Page 15 of 35

16 8. Then, to show the different values get from the VB script, some HTML lines are needed: 9. The final result should look like the following screen print: Make sure to allow block contents to run the script. 10. To see the entire script: first script Creation of a Luminaire Library This tutorial shows how to write a Visual Basic for Application script using a Word document to: Open an Optis Eulumdat Map Get the name of a luminaire and its corresponding polar curve to make a luminaire catalog If needed, you can download the LAB_Tutorials_Automation_LuminaireCatalog.zip (../Common/LAB_Tutorials_Automation_LuminaireCatalog.zip) file. 1. First, open a new Microsoft Word document. Page 16 of 35 OPTIS Labs Tutorials User Guide

2. To open the Visual Basic editor, select Tools, Macro and Visual Basic Editor or Alt+F11. 3.

Create a subroutine named CreaCatalog and the usual lines to get an Eulumdat viewer object. 4. Declare the FolderPath variable.

17 2. To open the Visual Basic editor, select Tools, Macro and Visual Basic Editor or Alt+F In the project tree, click on ThisDocument to show a blank page where the script is going to be written. Create a subroutine named CreaCatalog and the usual lines to get an Eulumdat viewer object. 4. Declare the FolderPath variable. This FolderPath variable must be initialized by the path where your project are located. The following picture show an example : 5. The following command lines execute a file search of all file with a name ending with.ldt (referring to an Eulumdat map), located in the folder FolderPath. Automation Page 17 of 35

18 The Right command can find four files with the ".Idt" extension. Don't forget to use the method GetHelpPath for the file search folder. 6. Then, MyFileName can have a screenshot from the Idt file : 7. Finally, we use Microsoft Word's APIs to generate the report. Page 18 of 35 OPTIS Labs Tutorials User Guide

8. The final result should look like the following screen print: 9. To see the entire script: second script Creating and Running a Macro Driving Virtual Reality Lab OPTIS Labs license is required.

19 8. The final result should look like the following screen print: 9. To see the entire script: second script Creating and Running a Macro Driving Virtual Reality Lab OPTIS Labs license is required. 20 minutes You are going to create and run a macro driving Virtual Reality Lab. This macro will control in real-time the ambiance lighting inside a car. Lesson 1: Preparing the Data The 2010 version of Microsoft Excel has been used here but any other version could fit. Another software as Matlab or Simulink could also have been used to create the script. 1. Follow the instructions on the SPEOS CAA V5 Based tutorial called Interior Car until the end. By doing so, you will finally obtain an OptisVR file. This file is generated by the inverse simulation with the Immersive sensor. 2. Rename the OptisVR file in InteriorCar.OptisVR and copy it onto the C:\ folder. The path C:\InteriorCar.OptisVR will be used in the script. If you decide to move the OptisVR file elsewhere, do not forget to also change the path on the script. Lesson 2: Configuring of Excel 1. Launch Microsoft Excel. If this is not the first time that you use Excel for the creation of macros, you can directly go to the next lesson. 2. Click File and select Options. 3. Click Customize Ribbon. 4. Tick Developer. Automation Page 19 of 35

20 The Excel Options box appears. 5. Click OK. You have now access to a new Excel tab called Developer: Lesson 3: Writing of the Macro 1. Save the book as Excel Macro-Enabled Workbook (*.xlsm) or similar format. 2. Type Alt + F11 from Excel. Page 20 of 35 OPTIS Labs Tutorials User Guide

21 The Visual Basic Editor appears. Another way to reach it is to click from the Developer tab. 3. Double-click ThisWorkbook on the Project Explorer. Automation Page 21 of 35

The Code field for the current book is displayed on the right. There is no content for the moment because no script has ever been written on this book. 4.

22 The Code field for the current book is displayed on the right. There is no content for the moment because no script has ever been written on this book. 4. Paste the following script onto the Code field: Private Declare Function GetTickCount Lib "kernel32" () As Long ' Function used to carry out the timer Public Sub xwait(byval MilsecToWait As Long) Dim lngendingtime As Long lngendingtime = GetTickCount() + (MilsecToWait) Do While GetTickCount() < lngendingtime DoEvents Loop End Sub Sub main() ' Variable for Error Management Dim Error As Integer ' Create an instance of VR Lab Dim VirtualRealityLab As Object Set VirtualRealityLab = CreateObject("HDRIViewer.Application") ' Show the window of VR Lab Error = VirtualRealityLab.Show(True) 'Open the file Error = VirtualRealityLab.OpenFile("C:\InteriorCar.OptisVR") Page 22 of 35 OPTIS Labs Tutorials User Guide

23 If Error = 0 Then End If MsgBox ("Your OptisVR file cannot be opened.") 'Active Human Vision for a 25-year observer Error = VirtualRealityLab.HumanVisionMode(True, False, 25) 'Set Local Adaptation Error = VirtualRealityLab.SetLuminanceMax(100) ' Initializations Dim SleepDuration As Long Dim Index As Integer ' Selection of the Excel sheet Sheets("Sheet1").Select ' Lower the power of the Sun Error = VirtualRealityLab.SetSourcePowerById(2, 0.01) ' Lower the power of the Environment Error = VirtualRealityLab.SetSourcePowerById(3, 0.01) ' Make evolve the source powers Index = 1 Do While Cells(Index + 1, 2) <> "" 'Set the Power of the red source Error = VirtualRealityLab.SetSourcePowerById(5, Cells(Index + 1, 3) * Cells(2, 7) / 100) 'Set the Power of the green source Error = VirtualRealityLab.SetSourcePowerById(6, Cells(Index + 1, 4) * Cells(2, 8) / 100) 'Set the Power of the blue source Error = VirtualRealityLab.SetSourcePowerById(7, Cells(Index + 1, 5) * Cells(2, 9) / 100) ' Sleep until the next time event If Index = 1 Then Else End If SleepDuration = Cells(Index + 1, 2) * 1000 SleepDuration = (Cells(Index + 1, 2) - Cells(Index, 2)) * 1000 xwait SleepDuration 'MsgBox (SleepDuration) ' Change the index for the next time event Automation Page 23 of 35

24 Loop Index = Index + 1 End Sub 5. Copy the table below and paste it on Sheet1 from the book. Be careful not to let any space on the top and on the left of the Excel sheet. If you do, the macro has to be modified to work properly. Time (s) P_Red (%) P_Green (%) P_Blue (%) P_Red (lm) P_Green (lm) P_Blue (lm) Turn off Page 24 of 35 OPTIS Labs Tutorials User Guide

25 Automation Page 25 of 35

26 Page 26 of 35 OPTIS Labs Tutorials User Guide

27 Automation Page 27 of 35

28 Blink Fall Page 28 of 35 OPTIS Labs Tutorials User Guide

29 Rise E Fall Automation Page 29 of 35

30 Rise E Page 30 of 35 OPTIS Labs Tutorials User Guide

31 Fall Automation Page 31 of 35

32 Rise E Page 32 of 35 OPTIS Labs Tutorials User Guide

10.85 13.5335 28 10.9 22.3130 16 10.95 36.7879 44 11 60.6530 66 99 5 0.40600 58 0.6 05 1.163 83 1.81959 2 0.27067 06 0.44626 0.73575 89 1.21306 13 11.

33 This table contains the power values (percentages) of the red, green and blue sources for each time (line). 6. Click Save. Lesson 4: Running of the Macro 1. Click Run. The Macros box appears. 2. Click Run. The script is running. A window of Virtual Reality Lab window is automatically displayed. Automation Page 33 of 35

34 We can observe that the macro changes in real-time the lighting inside the car. Feel free to change the point of view inside the car during the execution of the macro. 3. At the end of the macro, Virtual Reality Lab is automatically closed. Page 34 of 35 OPTIS Labs Tutorials User Guide

35 INDEX A AUTOMATION 13 C Creating and Running a Macro Driving Virtual Reality Lab 19 Creation of a Luminaire Library 16 Creation of a VB script 13 D Doing Legibility and Visibility Analysis 4 L Lesson 1 Preparing the Data 19 Lesson 2 Configuring of Excel 20 Lesson 3 Writing of the Macro 20 Lesson 4 Running of the Macro 33 U Using Automation 13 V VIRTUAL HUMAN VISION LAB 4

Excel 2013 Part 2. 2) Creating Different Charts

Excel 2013 Part 2. 2) Creating Different Charts Excel 2013 Part 2 1) Create a Chart (review) Open Budget.xlsx from Documents folder. Then highlight the range from C5 to L8. Click on the Insert Tab on the Ribbon. From the Charts click on the dialogue