Frequently Asked Questions
USB dongle-related issues
- The latest USB dongle drivers are always available from here: http://www.keylok.com/support/downloads.aspx
- Read KEYLOK's F.A.Q. and support: http://www.keylok.com/support/faq.aspx
I can't get the small thumbnail "Image Pop Up Windows" to display in iWitness or iWitnessPRO when using Vista or Windows 7, while it works fine in XP. Is there a way to fix this issue in Vista or Windows 7?
TIP SHEETS, HELP VIDEO CLIPS and TUTORIAL MOVIES
iWitness is a MS Windows based software program for measuring and modeling objects and scenes. iWitness uses the technology of close-range photogrammetry, where the three-dimensional coordinates (X,Y,Z) of feature points on an object photographed from two or more locations can be accurately determined by making two-dimensional measurements on digital images.
Designed for use by non-photogrammetrists, iWitness is a powerful yet easy-to-use tool. iWitness builds 3D models and measurements after a few easy clicks on the digital images imported into the program.
iWitness is the world leader in low-cost, close-range photogrammetry. It is unmatched in its abilities to solve easily and accurately for 3D image coordinates using consumer grade or fully metric digital cameras.
Yes, we've put together an iWitnessPRO Quick Reference Guide. However, we strongly recommend that you read the iWitnessPRO User Manaul too. After you install iWitnessPRO, the Users Manaul is located at C:\Program Files\iWitnessPRO\docs.
Yes, we've put together an XYRectify Tip Sheet. However, we strongly recommend that you read the XYRectify User Manaul too. XYRectify is a separate planar rectification program packaged and sold with iWitnessPRO.
How is iWitness used?
A few simple steps:
To learn more, please take the iWitness Tour.
What type of objects can iWitness measure and 3D model?
iWitness is optimized for use by law enforcement agencies, specifically in traffic accident reconstruction and forensic measurement. iWitness' powerful data acquisition and rigorous photogrammetric processing create fast, comprehensive 3D measurements as well as a permanent visual record of the scene being recorded.
The value of iWitness is not, however, restricted to the law enforcement sector. As a full-featured, close-range photogrammetric software system, iWitness can be applied to 3D reconstruction tasks in architecture, archaeology, engineering and medicine. iWitness handles the most complex measurement tasks: there are no restrictions on the number of images and measurement points.
What are the PC system requirements to run iWitness/iWitnessPRO?
What monitor screen settings are required?
iWitness /iWitnessPRO requires a personal computer with:
iWitness requires the "Color Quality" in the "Display Properties Settings" set at the highest possible settings (typically 32 bit). To achieve this, select the Control Panel+Display to assure the setting is made correctly.
Depending on the computers graphic card, there is a chance of experiencing OpenGL Hardware Acceleration problems, for the first time, when importing images or in the 3D graphics view of iWitness. This is easily corrected by adjusting the settings on the Hardware Acceleration Slider in the Control Panel+Display+Settings+ Advanced+Troubleshoot (tab).
What type of camera can I use?
iWitness works with any digital camera that reads the Exchangeable Image File Format (EXIF). Most digital cameras now use the EXIF format. The format is part of the DCF standard created by JEITA to encourage interoperability between imaging devices. For more information on EXIF reference the website http://www.exif.org.
We recommend a digital camera with at least 10 megapixel ccd resolution for use with iWitness. Remember, a higher camera pixel resolution creates more accurate photogrammetric results in iWitness.
iWitness also works with any film camera. However, it is important to realize the film negative or scanned film print must have square pixels. We recommend that ZARAF (a simple preprocessor utility tool) is used to assure the pixels are indeed square before importing the image into iWitness or iWitnessPRO.
How can I tell if my camera is already in the iWitness Camera Database?
iWitness stores most digital camera make and models in its Global database, but not all of them, as digital cameras are updated almost weekly. The Global database is continuously updated with new cameras. One can download the latest Global Database by clicking on the Global Camera Database's "Auto Update Button" (assuming one has an Internet connection).
How long does it take to create 3D models and measurements in iWitness?
Speed and efficiency separate iWitness from its competitors. The program's fast point marking and automatic camera orientation methods make it a breeze to operate, even by non-photogrammetrists.
Using iWitness, a simple project can be modeled in as little as five minutes. Very complex scenes can take up to several hours. Generally, the time required depends on the number of images being processed and the number of 3D objects requiring measurement and modeling. In the examples premiered on this website, operators with a basic understanding of the iWitness program created each project in under two hours.
iWitness will export to most Computer-Aided Design (CAD) programs, i.e., AutoCAD, AutoSketch, Crash and Crime Zone (by CAD Zone), MapScenes, Visual Statement, and many others that read the DXF file format.
In addition to the DXF file format, iWitness and iWitnesPRO allow for its Texture Mapping (textured entities including 3D vertices, image points of the texture and the texture itself) can be exported in the Virtual Reality Modeling Language VRML format. The VRML file and textures are saved as JPEG files. The image files comprise rectified images of the entities. A VRML Viewer is required to view the exported model.
What do I need to know in advance of using the iWitness software?
Is there a quick reference guide or a 'tip sheet' available?
Are there any special settings that are required on my PC to run iWitness?
TURN "USER ACCOUNT CONTROL" OFF
SCREEN DISPLAY COLORS
Why is it that when I take my calibration pictures and import them into iWitness, two cameras are presented for my one camera that I used to take the images?
In this instance, it is very likely that your camera images were recorded with Auto Rotate On. To use your digital images in iWitness, ensure that the Auto Rotate is set to Off.
Sharing Like Camera Model Calibrations On Multiple Computers (for iWitness V1.08 and higher version releases)
The process of adding a calibrated camera description to the iWitness Local Camera Database from the 'Host computer' to the 'Remote computer' can be accomplished with any project.iwp file, in which the camera calibration had already been performed. The camera must have a Unique ID assigned. In our example below, we are using the actual ‘calibration.iwp’ file to demonstrate the steps.
i) When first calibrating the camera on the Host computer, assign a Unique ID to the camera, in the Camera Parameters dialog box. Enter a specific camera name for the camera, (for example, you might enter the last 5 digits of the cameras serial number.)
ii) After you've calibrated the camera with the Unique ID on the Host computer, the iWitness Local Camera Database is automatically updated.
When images are imported into iWitness, a warning dialog box reads: "This camera is not in the database. Cameras details must be completed manually"
The iWitness camera database is continuously updated with digital camera information. However, there may be cases when your specific camera is not in the camera database, and a few simple actions are required before the camera can be calibrated. If the images were taken in JPEG format, there's a high probability that the images support the Exchangeable Image File (EXIF) header information. iWitness will read the EXIF header, thus we recommend the user takes their pictures in the highest resolution in JPEG format.
The iWitness User Manual, Part C, as well as Movie #2 on the iWitness CD Media provides an in-depth explanation of what actions are required when the images are EXIF, and also when they are not EXIF. We have prepared a PDF file than explains the most typical situation (i.e., when the images are EXIF, and are not in the iWitness Local or Global Database).
The camera icon in iWitness appears as a “cartoon camera”. Is there a way to update the cartoon camera so that my cameras specific make\model is displayed when I import images?”
Yes. We have created a simple procedure for this, and it is noted in the below PDF file.
I can't seem to find the specific pixel height and width of my digital cameras Sensor Type. Is there a reference guide I can use to determine this?
Yes. We have compiled a list of the most common sensors in the below noted PDF reference guide. The reference guide also provides an example of how to use the sensor size in iWitness, prior to conducting the camera calibration.
When I use the "Export TXT" function in the 3D Points List, and open up the file, I see seven columns of numbers. What are these numbers?
What does the “Quality” and the “Angle” represent in the 3D Point List?
Quality is the RMS value of image coordinate residuals for a given point. It is an internal measure of the network consistency. The quality value is influenced by the camera type (and if calibrated), as well as the precision of the point marking/referencing. With a commercial grade digital camera that has been calibrated by iWitness, the quality value will typically be in the range of 0.1 to 1.5 when proper image-marking is achieved. The lower the Quality number the better. It should be noted that estimates of Quality will likely appear artificially low when there are only two images and less than 8-12 referenced points. More representative quality estimates are obtained when the points are imaged from at least three camera positions (or 'sightings').
The Angle value is determined from the 'n' intersecting light rays to a point. The Angle is then defined by the maximum angle of intersection subtended by the pairs of two light rays that intersect at the point. It is desirable that the Angle value be higher than 20 degrees or so, and Angles of less than 10 degrees should be avoided where possible. iWitness will not allow a point to be referenced if its Angle value is less than 3 degrees.
Is there a quick reference guide for the criteria regarding the "iWitness Project Status Summary"?
Yes. We have compiled some helpful text boxes adjacent the Project Status Summary dialog box for quick reference - PDF form.
Possible problems achieving the "RO" or Green Tick Marks while accomplishing a camera calibration.
One issue might be the focal length of the camera is grossly in error. This is becomingly increasingly less of a concern as more cameras record the nominal focal length in the EXIF header of the jpeg images. iWitness initially looks in the local camera database for the appropriate focal length. If the camera is not found, it will then look for the focal length in the global camera database. Once it locates the camera, it reads the focal length from the EXIF header.
Is there a way to use iWitness to measure really small objects, like blood spatter?
Yes. We have compiled a helpful tip sheet. It will require that you calibrate your camera for close-up photography.
When I open up the project .iwp, the image thumbnails are pink. How do I fix this?
When renaming a project iwp, or moving the project folder with its images to e.g., a CD or DVD, the directory path to ‘point’ and acquire the project images is temporarily disconnected. The image thumbnails will appear as pink rectangles. To ‘point’ the iwp to the directory with the images, simply right mouse click with the cursor over any of the pink thumbnails which sets the Image Path. Path to your working folder where you’ve stored your images. Click on the image ‘xxxxxx.jpg’ that’s presented in the “Open” dialog box. Click the Open button Click “Yes” for “Set path for all images? Select the Save icon to save this new image path setting.
Is there an easy to follow procedure for using the "3D Transformation to Control" feature in iWitness?
We've created a very simple to follow process guide for using the 3D Transformation to Control using two networks stitched with four control points.
Is there a tip sheet for using Zaraf?
We have created a movie to show the process steps of ZARAF using a scanned image from a 35mm format camera. In order to accurately measure scanned film negatives or scanned film prints in photogrammetry, the pixels must be square in format height and width. Zaraf is a software utility program that assures the pixels (rows and columns) are square. It is important to realize that "square pixels" are only part of the requirements for producing accurate photogrammetric XYZ coordinates. The focal length and lens distortion must also be solved; see iWitness' "FOOM" process.
I'm having problems installing when using Vista 64 bit, what should I do?
In iWitness V1.4.2 and iWitnessPRO 1.05 we updated drivers that address these installation issues. In the C:\Program Files\iWitness (or iWitnessPRO) click on the "DongleInstall.exe". This will update required drivers.
If you are using earlier versions of iWitness (or iWitnessPRO) we recommend you contact us for the latest versions.
When I use iWitnessPRO with AutoCal codes for camera calibration, I'm getting all "Yellow tick marks, not Green tickmarks, why is that"?
Section D of the User Manual covers the procedure. By default, iWitnessPRO is designed to automatically read red targets (only). You can select the pulldown menu for Edit + Project Settings and then click on the check mark for "Colour" Targets. Proceed to running the AutoCal.
Optionally you can open one of the calibration images and click the Q-key on the keyboard. With the Image-Scanning & Auto Measurement dialog now displayed, you might notice the AutoCal Red/Green dots are not fully filled (i.e., a target "blob".) To correct this, click the "Optimize" button (note: it might take 10 seconds to re-process the threshold.) Click here to see an example. The figure illustrated on the left is without using the Optimize, while the figure of the right illustrates the Optimize with proper target "blobs". You can now run the calibration process from the Pull Down Menu (Photogrammetry + AutoCal.)
© 2014 DeChant Consulting Services - DCS Inc. All rights reserved.