Panoramic Measurement (PaMe Wizard) Tool Help
On this page you can find more info about the PaMe Wizard Measurement tool, how to install it and how to use it.
Introduction Video
Or visit: https://youtu.be/HQS4PEi6Ngo
About the 360˚ panoramic photo's and the virtual tour set-up
Make sure 'your panos' are properly vertical aligned. This means that vertical lines in the 360˚ photo should be vertical.
Make sure the resolution of the panos is enough to see and 'label' the lengths you want to measure.
Make sure the virtual tour code is made with Krpano or Panotour (pro). It is important that the panos are defined in 'scenes'. Make sure your project is running on krpano 1.20+
How to implement the PaMe Wizard in your virtual tour
Copy the 'pame' folder on the same level, in your main tour folder, as where you can find the the xml file that 'holds' the pano scenes. As the PaMe Wizard uses PHP, PaMe will work only online or on a local server. You need to upload these files and your project to a server. This server needs to be able to handle php!!
In your tours html page (often: tour.html or index.html) you need to add the jquery library in the 'head' section:
<script src="https://ajax.googleapis.com/ajax/libs/jquery/3.4.1/jquery.min.js"></script>
Include the pame.xml in your tour.xml like this:
<include url="pame/pame.xml" />
It is possible to edit the path to your viewer in the pame/measure.php
Help with installing is a part of the service and product.
If you like you can change the looks of PaMe.
For the selection tool, which is integrated in your tour, you can do this in the pame_settings.xml Here you can also design or put your own button to trigger the Selection tool.
the design of the dots or saved measurement poly lines and text you can find settings and code in the pame_design.xml
How to use the PaMe Wizard
Please understand that you need two panos to do the measurement(s).
Visit your tour online and look for two panos that show the item you want to measure in the 'green zone'. (see the 'accuracy areas' graphic below) The tool will be more accurate when the 'length', or the object you want to measure, is 'between' the two panos.
Press the 'M' on your keyboard to 'transport' the pano's to the tool.
Or feel free to make your own icon or button and call the 'ShowPaMe();' action. The PaMe wizard uses cookies to transport the pano's to the PaMe wizard page. Cookies should be enabled! No data about the panos or measurements is stored!
Visit the first pano, of the two, you want to use for measurement and press the P1 button in the tool. Or '1' on your keyboard.
Visit the second pano, of the two, you want to use for measurement and press the P2 button in the tool. Or '2' on your keyboard.
Enter the Measure Interface
After proceding you will automatically enter the measure interface. (This new page could be being blocked by the popup blocker of your browser settings).
Here you will do your measurement(s).
If you didn't save a calibration for this pano combination before or don't want to use it, you will have to choose a measurement protocol.
GPS
Known distance between panos
Known camera height
Known length
GPS
The GPS procedure takes the latitude and longitude information from your tour scene xml. Be sure it is entered there. Take care with this setting. Consumer GPS data is in most/much cases not accurate enough.
In the next release there will be more extended 'GPS' support.
Known distance between panos
If you know the exact distance between the camera positions you can use this option.
Known camera height
If you know the exact camera height, you could use this option. Both camera's should be more or less on the same height. Individual camera height input will be available in a next release.
Known length
If you are aware of an exact length of any kind in the pano, for example the width of a door, you could use that option.
After the choice and, in some cases, an input, we can continue with calibrating both panos. (The accuracy offset of this input is translating, about, 1:1 in percentual measured distance offset.)
Look with pano 1 as exactly as possible to the position of pano 2. Look with pano 2 to the same distance point as pano 1. The red bar in the panos gives instructions.
It is important to do this as good as possible.
You can save the current calibration for these two specific pano's in the 'result page', which i would highly recommend.
Click proceed.
ALIGN THE PANOS
It depends on previous choices, what will happen now.
- GPS : you can start measuring.
- Distance: You can start measuring
- Camera height: You need to place in each pano a (blue) dot on the ground near, NOT on, the line between the camera's, make sure you have a 'nice' triangle between the dot and the camera's. The 2 dots should 'mark' the same location. When finished, click done.
- Known length: You need first to mark the known length on both sides in both panos. Yellow and green dots will appear. When finished, click done.
Instruction will also be shown inside the tool. We are going to measuring a length. Because of that we need the outside positions of the 'length'/distance. Find the object or 'length' in pano 1 and click on the most outer left (or right) side. A red dot appears which is also draggable for replacement. You can also go fullscreen, rightbottom of the pano 'box', for more accuracy. Now click on the otherside of the 'length'. A white dot appears.
Do the same in pano 2 and make sure the position of the red and white dots correspondent.
Now click calculate distance. The page will show the distance you measured.
This picture shows the accuracy 'areas'.
Don't try to measure in the red area ( Aproximately 5˚ ). The accuracy can be bad. In the yellow area the accuracy could be not ideal. Make sure that for high accuracy the length to be measure is between the panos.
Also measuring close to the zenith or nadir (straight up or down) is not recommended.
Also, be carefull with small/little parallax positions and angles.
Angle 'A' can be too small to do a proper measurement in some cases. A warning alert will show.
Problems
The PaMe tool seems to be very accurate. Be as precise as possible.
If you find problems, bugs or have questions, don't hesitate and send me an Email.
Add PaMe to your project
Or visit: https://youtu.be/E2l5tXCIJYA
First steps, calibrations, settings, measure
Or visit: https://youtu.be/TZn8MAWZNEY
Measure protocols
Or visit: https://youtu.be/jS9sAiornH0
Introduction Video
Or visit: https://youtu.be/HQS4PEi6Ngo
About the 360˚ panoramic photo's and the virtual tour set-up
How to implement the PaMe Wizard in your virtual tour
Copy the 'pame' folder on the same level, in your main tour folder, as where you can find the the xml file that 'holds' the pano scenes. As the PaMe Wizard uses PHP, PaMe will work only online or on a local server. You need to upload these files and your project to a server. This server needs to be able to handle php!!
In your tours html page (often: tour.html or index.html) you need to add the jquery library in the 'head' section:
<script src="https://ajax.googleapis.com/ajax/libs/jquery/3.4.1/jquery.min.js"></script>
Include the pame.xml in your tour.xml like this:
<include url="pame/pame.xml" />
It is possible to edit the path to your viewer in the pame/measure.php
Help with installing is a part of the service and product.
If you like you can change the looks of PaMe.
For the selection tool, which is integrated in your tour, you can do this in the pame_settings.xml Here you can also design or put your own button to trigger the Selection tool.
the design of the dots or saved measurement poly lines and text you can find settings and code in the pame_design.xml
How to use the PaMe Wizard
Please understand that you need two panos to do the measurement(s).
Or feel free to make your own icon or button and call the 'ShowPaMe();' action. The PaMe wizard uses cookies to transport the pano's to the PaMe wizard page. Cookies should be enabled! No data about the panos or measurements is stored!
Enter the Measure Interface
After proceding you will automatically enter the measure interface. (This new page could be being blocked by the popup blocker of your browser settings).
Here you will do your measurement(s).
If you didn't save a calibration for this pano combination before or don't want to use it, you will have to choose a measurement protocol.
GPS
The GPS procedure takes the latitude and longitude information from your tour scene xml. Be sure it is entered there. Take care with this setting. Consumer GPS data is in most/much cases not accurate enough.
In the next release there will be more extended 'GPS' support.
Known distance between panos
If you know the exact distance between the camera positions you can use this option.
Known camera height
If you know the exact camera height, you could use this option. Both camera's should be more or less on the same height. Individual camera height input will be available in a next release.
Known length
If you are aware of an exact length of any kind in the pano, for example the width of a door, you could use that option.
After the choice and, in some cases, an input, we can continue with calibrating both panos. (The accuracy offset of this input is translating, about, 1:1 in percentual measured distance offset.)
Look with pano 1 as exactly as possible to the position of pano 2. Look with pano 2 to the same distance point as pano 1. The red bar in the panos gives instructions.
It is important to do this as good as possible.
You can save the current calibration for these two specific pano's in the 'result page', which i would highly recommend.
Click proceed.
ALIGN THE PANOS
It depends on previous choices, what will happen now.
- GPS : you can start measuring.
- Distance: You can start measuring
- Camera height: You need to place in each pano a (blue) dot on the ground near, NOT on, the line between the camera's, make sure you have a 'nice' triangle between the dot and the camera's. The 2 dots should 'mark' the same location. When finished, click done.
- Known length: You need first to mark the known length on both sides in both panos. Yellow and green dots will appear. When finished, click done.
Instruction will also be shown inside the tool. We are going to measuring a length. Because of that we need the outside positions of the 'length'/distance. Find the object or 'length' in pano 1 and click on the most outer left (or right) side. A red dot appears which is also draggable for replacement. You can also go fullscreen, rightbottom of the pano 'box', for more accuracy. Now click on the otherside of the 'length'. A white dot appears.
Do the same in pano 2 and make sure the position of the red and white dots correspondent.
Now click calculate distance. The page will show the distance you measured.
This picture shows the accuracy 'areas'.
Don't try to measure in the red area ( Aproximately 5˚ ). The accuracy can be bad. In the yellow area the accuracy could be not ideal. Make sure that for high accuracy the length to be measure is between the panos.
Also measuring close to the zenith or nadir (straight up or down) is not recommended.
Also, be carefull with small/little parallax positions and angles.
Angle 'A' can be too small to do a proper measurement in some cases. A warning alert will show.
Problems
The PaMe tool seems to be very accurate. Be as precise as possible.
If you find problems, bugs or have questions, don't hesitate and send me an Email.
Add PaMe to your project
Or visit: https://youtu.be/E2l5tXCIJYA
First steps, calibrations, settings, measure
Or visit: https://youtu.be/TZn8MAWZNEY
Measure protocols
Or visit: https://youtu.be/jS9sAiornH0
