[opticalraytracer] 03/06: Update patches
D Haley
mycae-guest at moszumanska.debian.org
Thu May 14 22:55:09 UTC 2015
This is an automated email from the git hooks/post-receive script.
mycae-guest pushed a commit to branch master
in repository opticalraytracer.
commit 4a05f0e4a55fd028128df4c0f68303518c849ece
Author: D Haley <mycae at gmx.com>
Date: Fri May 15 00:17:44 2015 +0200
Update patches
---
debian/patches/series | 1 -
src/opticalraytracer/helpresources/HelpText.html~ | 1092 ---------------------
2 files changed, 1093 deletions(-)
diff --git a/debian/patches/series b/debian/patches/series
index 3c55ad2..0b447aa 100644
--- a/debian/patches/series
+++ b/debian/patches/series
@@ -1,3 +1,2 @@
build-xml.patch
jar-path.patch
-disable-ant-propertyfile.patch
diff --git a/src/opticalraytracer/helpresources/HelpText.html~ b/src/opticalraytracer/helpresources/HelpText.html~
deleted file mode 100644
index c525302..0000000
--- a/src/opticalraytracer/helpresources/HelpText.html~
+++ /dev/null
@@ -1,1092 +0,0 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-<html xmlns="http://www.w3.org/1999/xhtml">
- <head>
- <!-- UTF8 MODIFIER -->
- <title>
- * OpticalRayTracer
- </title>
- <style type="text/css">
-table {
- background:#fffff0;
-}
-
-table tr td, table tr th {
- border-width:1px;
- border-style:solid;
- border-color:black;
- white-space:nowrap;
- }
-
-th {
- text-align:center;
- font-weight:bold;
- background:#c0d0c0;
-}
-.article_subtopic {
- font-weight:bold;
-}
- </style>
- </head>
- <body bgcolor="#ffffff" text="#000000" link="#0000ff" vlink="#800080" alink="#ff0000">
-
- <div align="center">
- <p><h2><img src="../icons/OpticalRayTracer.png" width="32" height="32" title="" alt=""/> OpticalRayTracer #version# Help Page</h2></p>
-
-
- <p><i>A virtual lens/mirror design workshop.</i></p>
- <p>Copyright © 2014, <a href="http://arachnoid.com/administration/index.html" title="Click for biography">Paul Lutus</a> -- <a href="http://arachnoid.com/messages/index.php">Message Page</a></p>
-
- <p>OpticalRayTracer is released under the <a href="http://www.gnu.org/licenses/gpl.html">GPL</a>.</p>
-
- <p>Visit the <a href="http://arachnoid.com/OpticalRayTracer">OpticalRayTracer Home Page</a> for more information and to be sure you have the latest version.</p>
-
-
- <p><i>For formatting reasons, users may want to temporarily make the OpticalRayTracer program frame larger to properly read these instructions.</i></p>
-
- <p><i>Users may prefer to search this document using the search feature at the bottom of this frame.</i></p>
-
- <p><!-- LINK_MENU_START -->
- <a href="#Introduction">Introduction</a> | <a href="#First_Steps">First Steps</a> | <a href="#The_Basics_of_Lenses">The Basics of Lenses</a><br/>
- <a href="#Supported_Optical_Elements">Supported Optical Elements</a> | <a href="#Mirrors">Mirrors</a> | <a href="#Absorbers">Absorbers</a><br/>
- <a href="#Tutorial">Tutorial</a> | <a href="#Lens_Control_Panel">Lens Control Panel</a> | <a href="#Dispersion_Experiment">Dispersion Experiment</a><br/>
- <a href="#Using_the_Mouse_and_Keyboard">Using the Mouse and Keyboard</a> | <a href="#Importing_and_Exporting_Data">Importing and Exporting Data</a> | <a href="#System_Considerations">System Considerations</a><br/>
- <a href="#Algorithm_Description">Algorithm Description</a> | <a href="#Snell_s_Law">Snell's Law</a> | <a href="#Dispersion_Computation">Dispersion Computation</a><br/>
- <a href="#Design_Options">Design Options</a> | <a href="#Configuration_Options">Configuration Options</a> | <a href="#Conclusion">Conclusion</a><br/>
- <a href="#User_support">User support</a>
- <!-- LINK_MENU_END --></p>
-
-
-
-
- </div>
- <p></p>
-
- <a name="Introduction"></a><div class="article_subtopic">Introduction</div>
-
-
-
-
- <blockquote>
- <p>OpticalRayTracer is a very portable Java program meant to analyze and model systems of lenses. It accurately models the physics of lenses, including the effect known as dispersion. But perhaps the most remarkable thing about OpticalRayTracer is that it updates and displays complex ray tracing paths in real time, as the user moves virtual lenses around on a virtual optical bench. This allows the user to very quickly learn the behavior of a system of lenses, compare, experiment, a [...]
-
- <p>OpticalRayTracer places its configuration file in a directory it creates, so your settings and choices are preserved. This directory is located at #userdir# on your machine, and it contains a configuration file named "OpticalRayTracer.ini" containing quite a lot of detailed information unique to your use of the program.</p>
-
-
-
- <p>I mention this because:</p>
-
- <ul>
- <li>if you want to analyze or process the results of your work with OpticalRayTracer, the file #userdir#/OpticalRayTracer.ini contains a lot of numeric information in plain-text form, and</li>
- <li>if you have gotten into difficulty and just want to start over, simply delete this file and run OpticalRayTracer again.</li>
- </ul>
-
-
-
- <p>This file contains a very detailed snapshot of your last session with OpticalRayTracer, with lens specifications and positions, suitable for exporting into other environments (the same information can be gotten from the <img src="../icons/edit-copy.png" width="22" height="22" style="vertical-align:middle;" title="" alt=""/> copy-configuration button on the Design toolbar). To create this file and its picture of your optical setup, simply exit OpticalRayTracer, navigate to #userd [...]
-
-
- </blockquote>
-
- <a name="First_Steps"></a><div class="article_subtopic">First Steps</div>
-
- <blockquote>
-
-
-
- <p>Since you are reading this, you have successfully installed OpticalRayTracer, and are ready to try some experiments.</p>
-
- <p>When it is first run, the program will automatically create two common lenses for you, a double-convex lens and a double-concave lens. Click the <img src="../icons/applications-graphics.png" width="22" height="22" style="vertical-align:middle;" title="" alt=""/> "Design" tab and you will most likely see these two default lenses. If you do not see any lenses, click the <img src="../icons/process-stop.png" width="22" height="22" style="vertical-align:middle;" title="" alt=""/> "Er [...]
-
- <p>Navigation within the ray trace display is as intuitive as I could make it:</p>
-
- <ul>
- <li>To zoom in and out, use your mouse wheel.</li>
-
- <li>To pan around the display, just drag the mouse cursor on the display.</li>
-
- <li>To move a lens from one place to another in the display, click the lens while holding the Shift or Ctrl key down, and drag it.</li>
-
- <li>There's more detail on these functions below in "Using the Mouse and Keyboard".</li>
- </ul>
-
- <ul>
- <li>The display has two dimensions, "x" and "y". "x" is the horizontal dimension, and positive values for x move to the right. "y" is the vertical dimension, and positive values for y move up.</li>
-
- <li>To move large distances, first zoom out (mouse wheel), then pan (drag mouse cursor), then zoom in again. This saves time compared to clicking and dragging multiple times.</li>
-
- <li>To determine the position of something in the display, for example the location of a focal point, simply point the mouse cursor at the point of interest and read the mouse x and y position on the status bar (bottom of program window).</li>
- </ul>
-
- <p>The default setup shows ten light beams passing from left to right, through two example lenses. The mathematical methods used in this program are efficient enough that (with a moderately fast computer) you can move the lenses around and see how this changes the beam paths -- in real time. Try it -- move the lenses around (hold the Shift or Ctrl key down, click a lens and drag it) and observe the changing beam paths.</p>
-
- <p>Notice that, when you click a lens, the lens changes color and the design control panel below the display becomes active. This panel allows you to change the characteristics of your lenses -- focal length, size, curvature, and many other things. Feel free to experiment with this panel's settings -- see how they change the appearance of the lenses and light beams.</p>
-
- <ul>
- <li>If you make a change you don't like, simply press the <img src="../icons/edit-undo.png" width="22" height="22" style="vertical-align:middle;" title="" alt=""/> "Undo" button to change back.</li>
-
- <li>To change the settings for a lens, first click the lens, then use the lens control panel to make the changes you want.</li>
- </ul>
-
- <p>It will help to know a little about optics to understand what you are seeing. If you already know the basics, you can safely skip the next few lines.</p>
-
- </blockquote>
- <a name="The_Basics_of_Lenses"></a><div class="article_subtopic">The Basics of Lenses</div>
-
- <blockquote>
-
- <p>Very basically, a lens is a simple way to bend light beams. Imagine a row of soldiers marching, side by side. To change the direction they're marching, it is necessary to make some of the soldiers slow down temporarily. Now let this picture of marching soldiers help you imagine a light wave, traveling through space. Just as with the soldiers, to make the wave change direction, you have to think of a way to make part of the wave slow down. That is what a lens does -- it selective [...]
-
- <p>A convex lens is thicker in the middle than at the edges, and, as it turns out, light takes longer to pass through glass than through air. What this means is that the light that passes through the middle, thickest part of the lens, is slowed down compared to the light that passes through the thinner parts near the edges of the lens. This has the effect of shaping the wavefront that emerges from the lens -- the middle of the emerging wavefront is delayed, and the wave's overall s [...]
-
- <p>Such a lens could be used to focus parts of a real-world scene onto a piece of film or an image sensor. The ability of a lens to focus accurately is a central issue in lens design and, as it turns out, the most common kind of lens, with a spherical shape, is actually not a very good design. Its only advantage is that it's easy to make -- everything after that is downhill.</p>
-
-
- </blockquote>
-
- <a name="Supported_Optical_Elements"></a><div class="article_subtopic">Supported Optical Elements</div>
-
- <blockquote>
-
- <p>OpticalRayTracer supports a variety of optical elements:</p>
-
- <ul>
- <li>Lenses with these curvatures:
- <ul>
- <li>Spherical -- a classic lens, dating back to the time of Galileo, and the most common lens type. Its surface can be thought of as the intersection of two spheres. Indeed, in optical modeling software including OpticalRayTracer, that's exactly the mathematical approach taken -- a double-convex lens is modeled as the intersection of two imaginary spheres that give the lens its shape and characteristics.</li>
- <li>Parabolic -- although most useful in modeling the mirror types supported by OpticalRayTracer, lenses may aso be given a parabolic profile.</li>
- <li>Hyperbolic -- this lens type has become increasingly popular as its ability to overcome spherical aberration becomes more widely understood. Although difficult to manufacture, hyperbolic lenses are far superior to other lens types for ideal focus and other characteristics.</li>
- <li>Planar -- an optically flat plane, used primarily for mirrors and beam absorbers.</li>
- </ul>
- </li>
- <li>Mirrors. OpticalRayTracer can turn any optical surface into a mirror, so all the above-described curvatures can be applied to a reflecting surface. This is particularly important for telescope design and in the design of certain kinds of solar energy devices.</li>
- <li>Absorbers. These are used to terminate optical paths in a controlled way at a specificed distance. Once absorbed, a light ray appears in OpticalRayTracer's data table for analysis.</li>
- </ul>
-
- <p>OpticalRayTracer will let you play with various kinds of simple, spherical lenses in its virtual playground, but it also includes some mathematical methods that allow you to fashion some rather extraordinarily good lenses called "hyperboloids," famous for their accuracy ... and their difficulty of manufacture. These kinds of lenses are so expensive that it is simpler -- and much less expensive -- to build and test such lenses using a program like OpticalRayTracer than to try to [...]
-
- </blockquote>
-
- <a name="Mirrors"></a><div class="article_subtopic">Mirrors</div>
-
- <blockquote>
-
- <p>Recent OpticalRayTracer versions allow the creation of mirrors -- more specifically, lenses that behave like mirrors. The user creates a suitable flat or curved surface and clicks the design tab's "Reflector" checkbox. This feature allows diverting light beams out of the normal optical path, as well as the creation of concave and convex mirrors, such as are used in astronomical telescopes.</p>
-
- <p>To produce a generic mirror, click the "New mirror/absorber" toolbar button. Now you may change the mirror's characteristics, just as for a lens. Remember that, if it has a curved surface, a mirror can act as a lens. To tilt the mirror in the optical path, choose an appropriate value for the angle entry. By creating two mirrors, one concave reflector as an objective lens and a smaller diagonal mirror, it's possible to build a virtual Newtonian telescope and analyze the beam paths.</p>
-
- <p>If you encouter a case where a mirror won't reflect light, try increasing the mirror's thickness. OpticalRayTracer tries to avoid drawing the same object repeatedly, and it does this by measuring very small distances, and skipping objects that it thinks it may already have drawn. If your mirror is thin enough, OpticalRayTracer may not "see" it. This is true in nature too, but for a different reason.</p>
-
-
- </blockquote>
-
- <a name="Absorbers"></a><div class="article_subtopic">Absorbers</div>
-
- <blockquote>
-
- <p>An absorber is a third kind of supported optical object, and is a variation on mirrors. It's used in cases where the user wants to eliminate one or more rays from the calculation. To create an absorber, just create a mirror as explained above, then select "Absorb" from the design tab's option checklist. All rays that intersect with an absorber are terminated and play no further part in the optical calculation.</p>
-
-
- </blockquote>
-
- <a name="Tutorial"></a><div class="article_subtopic">Tutorial</div>
-
- <blockquote>
-
- <p>I want you to perform your own experiments, but here's a simple tutorial to get you started. Using the default lenses automatically created when you run OpticalRayTracer the first time, temporarily drag the concave lens (the lens at the right) out of the optical path. If you drag it a small distance, it will jump back into place, realigning itself with the beam line (ordinarily this automatic feature is a good thing). So drag it a good distance up or down, temporarily removing i [...]
-
- <ul>
- <li>"Lens Radius" refers to the distance from the center to the edge of the lens itself. Very simple.</li>
-
- <li>"Sphere radius" refers to imaginary spheres that our lens is composed of. Imagine two spheres of glass floating in space, overlapping to some extent, and then imagine that our lens represents the parts of the spheres that overlap. To help in visualizing this, draw two circles on a piece of paper using a coin and a pencil, and be sure to allow some overlap between the circles. The area where the circles overlap is our lens. Starting with this paper diagram, one need only use i [...]
- </ul>
-
- <p>As it turns out, the mathematics behind lenses relies very much on this idea of overlapping spheres, hyperboloids, and some other useful shapes. So if you can mentally picture two overlapping spheres, you will be able to predict what will result from your typing particular numbers into OpticalRayTracer. For example, to create a lens with one side convex and one side flat, you might choose to enter a very, very large radius for one side. Like this:</p>
-
- <ul>
- <li>Select the double-convex lens by clicking it.</li>
-
- <li>Deselect the "symmetrical" check box, which will allow you to choose different traits for the left and right-hand sides of your lens.</li>
-
- <li>Select "Planar" for the left side curvature type.</li>
-
- <li>You will see that the right-hand side of the lens has become flat, and (because we now have a lens with less overall curvature), the beams travel farther to the right before converging. The lens is said to have a longer <i>focal length</i>.</li>
- </ul>
-
- <p>At this point, you may wonder why an entry defining the left-hand sphere had its effect on the right hand side of our lens. The answer is that the imaginary spheres are overlapping, and the <i>right-hand</i> part of our lens is defined by an imaginary sphere centered to the <i>left</i> of the lens. I mention this now to avoid confusion later on. The circle that defines the right-hand side of the overlapped region (e.g. the lens) is centered to the left of the overlap area.</p>
-
- <p>Now for something a tiny bit more advanced.</p>
-
- <ul>
- <li>Select the default convex lens by clicking on it.</li>
-
- <li>Re-select "Spherical" for the left curvature type and enable "symmetrical" again by clicking its checkbox, restoring our lens to its original state -- a simple, symmetrical double-convex lens.</li>
-
- <li>Drag the mouse on the display to pan over to the region between x = 4 and 6 (remember that "x" means the horizontal axis), where the beams should now be converging. Once you have centered this part of the display, use the mouse wheel to zoom in a bit for a closer look.</li>
-
- <li>While looking as the point where the beams converge, click the left "Hyp" checkbox (because you selected "symmetrical" above, this entry will affect both sides of our lens). The lens focus should greatly improve.</li>
-
- <li>A quick reality check -- what constitutes an "improvement" in a lens? Well, ideally, all the beams should converge on a single point, rather than taking slightly different paths as they are doing now.</li>
-
- <li>Now we are going to fine-tune our lens by entering a value for hyperboloid curvature. Type "40" into the left "Hyperbolic curvature" window, and press Enter. If you have entered all the right values up to now, this should produce a nearly perfect focus -- all the beams should converge on a single point, located at roughly x = 5.4.</li>
- <li>To discover how accurate this focus is, center the focal point in the display and zoom in on it (use your mouse wheel). Eventually you will get to a point where you can see some small imperfections in the focus. (This will become visible at a zoom factor of about 5.)</li>
- <li>At this point you can fine-tune the lens' properties by carefully adjusting its hyperbolic curvature factor, which has an optimum near the value of 39. One way to make this adjustment is to position your mouse cursor over the hyperbolic curvature entry window and spinning the mouse wheel.</li>
- </ul>
-
- <p>Hyperbolic-curvature lenses are an example of advanced optics and were once very difficult to manufacture. As computers come to play a greater role in optical manufacturing, these high-performance lenses should become more common.</p>
-
- </blockquote>
-
- <a name="Lens_Control_Panel"></a><div class="article_subtopic">Lens Control Panel</div>
-
- <blockquote>
-
- <p>Play with some of the settings in the lens control panel (the panel located on the "Design" tab) to see what effect they have. Notice that you can reposition a lens exactly by entering its x and y coordinates -- this is a way to get around the fact that it is difficult to position a lens precisely using the mouse.</p>
-
- <p>Notice the entry marked "IOR". This means "Index of Refraction," a value representing the ratio of the speed of light through the lens in question to a vacuum (which has an IOR of 1.0). If you set this value to 1.0, the lens will no longer deflect the light beams, because the lens has in essence been redefined as empty space.</p>
-
- <p>Different glasses have different indices of refraction, a property we can take advantage of in advanced lens designs. Here's an example design that displays the effect called dispersion using differently colored light beams.</p>
-
- <p>"Dispersion" is a property of glass in which light beams of different wavelengths travel at different speeds. For example, a blue beam takes longer to move through a lens than a red beam. This causes the two colors (wavelengths) of light to focus at two different places, a trait regarded as a bad thing, called "chromatic aberration."</p>
-
- </blockquote>
-
- <a name="Dispersion_Experiment"></a><div class="article_subtopic">Dispersion Experiment</div>
-
- <blockquote>
-
- <p>This is an optional digression for the curious. To set up for this experiment:</p>
-
- <ul>
- <li>Delete any existing lenses.</li>
- <li>Switch to the "Configuration" panel and enter "0" for "Snap-To-Grid Value" and "2" for "Light Beam Count".</li>
- <li>Create a lens with these settings (or you can copy its definition from this page -- see below):
-
- <p><ul>
- <li>Symmetrical: selected.</li>
- <li>Lens Radius: 2.0</li>
- <li>Left Sphere Radius: 5.0</li>
- <li>Right Sphere Radius: 5.0</li>
- <li>Lens Thickness: 0.0</li>
- <li>Index of Refraction: 1.52</li>
- <li>Abbe number: 59</li>
- <li>X position: 0.0</li>
- <li>Y position: 0.0</li>
- </ul></p>
-
- </li>
-
-
- <li><a href="file:/opticalraytracer/helpresources/dispersionTestLens1.txt">Click here ("Crown" glass lens)</a> to copy this lens definition onto the clipboard, then paste it into the experimental setup using the display context (right-click) menu (use "Paste: defined position").</li>
-
- <li>Now return to the ray trace display to see the effect.</li>
-
- <li>If all your settings are correct, and if the lens has really been positioned at x = 0, y = 0, the two beams should converge at about x = 3.7.</li>
-
- </ul>
-
- <p>Now we'll add a dispersion calculation.</p>
-
- <ul>
-
- <li>Go to the "Configuration" panel and enter "8" for "Dispersion beam count."</li>
- </ul>
- <p>When you return to the ray trace display, you should see an array of colored beams near the lens focal point. In this mode, OpticalRayTracer creates colored beams, each of which has an associated wavelength. During the calculation of the ray paths, the lens dispersion property is taken into account and, just as in the real world, the lens cannot focus all these wavelengths onto a single point.</p>
-
- <ul>
- <li>Moving right along, create a second lens (or copy its definition from this page -- see below) with these properties:
-
- <p><ul>
- <li>Symmetrical: deselected.</li>
- <li>Lens Radius: 2.0</li>
- <li>Left Sphere Radius: 10000</li>
- <li>Right Sphere radius: -5</li>
- <li>Lens Thickness: 0.3</li>
- <li>Index of Refraction: 1.72</li>
- <li>Abbe number: 29</li>
- <li>X position: 0.347</li>
- <li>Y position: 0.0</li>
- </ul></p>
-
-
- </li>
- <li><a href="file:/opticalraytracer/helpresources/dispersionTestLens2.txt">Click here ("Flint" glass lens)</a> to copy this lens definition onto the clipboard, then paste it into the experimental setup using the display context (right-click) menu (use "Paste: defined position").</li>
-
- <li>If all the settings on both lenses are correct and all the other required settings have been made correctly, you will see all the colored beams converge at about x = 14.6, with <i>very little</i> color dispersion.</li>
-
- <li>It's possible to adjust the spacing between the lenses, which is both very sensitive and critical for the effect being modeled:
-
- <p> <ul>
- <li>Select the concave lens, the lens at the right, by clicking it -- it will become green.</li>
- <li>Pan over to the focal point (drag your mouse) and zoom in on the point where the beams cross (mouse wheel), choose a high magnification like 10 (readable on the status bar).</li>
- <li>Select the Design tab and click the X Position entry window.</li>
- <li>Now, while holding down the Shift and Alt keyboard keys (to greatly reduce the rate of change), spin your mouse wheel over the X Position window, and notice the effect on the focal point's position and quality.</li>
- <li>This procedure tunes the spacing betweeen the lenses by a very small amount, to optimize the dispersion effect.</li>
-
- </ul></p>
-
- </li>
-
- </ul>
-
- <p>This, by the way, is a <a href="http://en.wikipedia.org/wiki/Achromatic_lens">classic solution</a> to the problem of chromatic aberration, using varieties of glass called "crown" and "flint," with differing properties that are exploited to make the light beams converge.</p>
-
- <p>By changing the spacing between the two lenses, you will quickly see that this setting is very critical to the outcome, which is why in the real world, such pairs of lenses are often glued together or placed in a lens cell with a spacer of some durable material to maintain the required separation.</p>
-
- </blockquote>
-
- <a name="Using_the_Mouse_and_Keyboard"></a><div class="article_subtopic">Using the Mouse and Keyboard</div>
-
- <blockquote>
-
- <p><b>Graphic display</b></p>
-
- <p>While playing with lens configurations, you may sometimes notice it is difficult to select a particular lens because the lenses are close together and their selection territories overlap. In a case like this, just click the display repeatedly -- the program will cycle through the lenses that could be selected at the location of your click. You also have the option of cycling among the objects by clicking the <img src="../icons/view-refresh.png" width="22" height="22" style="vert [...]
-
- <p>The graphic display pays attention to the mouse's various buttons and wheel, plus certain keyboard keys. Here's a list of mouse-related inputs and actions:</p>
-
- <blockquote>
- <table cellspacing="-1" cellpadding="4" class="bordered">
-
- <tr>
- <th>
- Action
- </th>
- <th>
- Result
- </th>
- </tr>
-
- <tr>
- <td>
- Click once
- </td>
- <td>
- Select an object near the mouse cursor
- </td>
- </tr>
-
- <tr>
- <td>
- Click more than once
- </td>
- <td>
- Cycle through objects near mouse cursor
- </td>
- </tr>
-
- <tr>
- <td>
- Double-click
- </td>
- <td>
- List properties of nearest line
- </td>
- </tr>
-
- <tr>
- <td>
- Drag mouse
- </td>
- <td>
- Pan display
- </td>
- </tr>
-
- <tr>
- <td>
- Drag mouse with Shift or Ctrl keys
- </td>
- <td>
- Move selected object
- </td>
- </tr>
-
- <tr>
- <td>
- Mouse wheel
- </td>
- <td>
- Zoom display
- </td>
- </tr>
-
- <tr>
- <td>
- Mouse wheel with Shift key
- </td>
- <td>
- Rotate selected object
- </td>
- </tr>
-
- <tr>
- <td>
- Mouse wheel with Ctrl key
- </td>
- <td>
- Resize selected object
- </td>
- </tr>
-
- <tr>
- <td>
- Most of the above actions with Alt key
- </td>
- <td>
- Slower change
- </td>
- </tr>
-
- </table>
-
- </blockquote>
-
- <p>Here is a list of keyboard-related inputs and actions:</p>
-
-
- <blockquote>
- <table cellspacing="-1" cellpadding="4" class="bordered">
-
- <tr>
- <th>
- Action
- </th>
- <th>
- Result
- </th>
- </tr>
- <tr>
- <td>
- Tab
- </td>
- <td>
- Move forward through all program controls
- </td>
- </tr>
- <tr>
- <td>
- Shift|Tab
- </td>
- <td>
- Move in reverse through all program controls
- </td>
- </tr>
- <tr>
- <td>
- Alt-D
- </td>
- <td>
- Design tab
- </td>
- </tr>
-
- <tr>
- <td>
- Alt-C
- </td>
- <td>
- Configure tab
- </td>
- </tr>
- <tr>
- <td>
- Alt-T
- </td>
- <td>
- Table tab
- </td>
- </tr>
- <tr>
- <td>
- Alt-H
- </td>
- <td>
- Help tab
- </td>
- </tr>
- <tr>
- <td>
- F1
- </td>
- <td>
- Concise help dialog
- </td>
- </tr>
- <tr>
- <td>
- M or context menu key
- </td>
- <td>
- Context [M]enu
- </td>
- </tr>
- <tr>
- <td>
- Enter (over object)
- </td>
- <td>
- Select object under cursor
- </td>
- </tr>
- <tr>
- <td>
- Enter (outside objects)
- </td>
- <td>
- List properties of nearest line
- </td>
- </tr>
- <tr>
- <td>
- L
- </td>
- <td>
- [L]ist properties of nearest line (even inside objects)
- </td>
- </tr>
- <tr>
- <td>
- O
- </td>
- <td>
- Cycle through [O]bject selections
- </td>
- </tr>
- <tr>
- <td>
- U
- </td>
- <td>
- [U]nselect all objects
- </td>
- </tr>
- <tr>
- <td>
- Up/down/left/right Arrow keys
- </td>
- <td>
- Pan display
- </td>
- </tr>
-
- <tr>
- <td>
- Ctrl|Arrow or Shift|Arrow keys
- </td>
- <td>
- Move selected object
- </td>
- </tr>
-
- <tr>
- <td>
- +/- or Home/End
- </td>
- <td>
- Zoom display in/out
- </td>
- </tr>
-
- <tr>
- <td>
- Ctrl|(+/-) or Ctrl|(Home/End)
- </td>
- <td>
- Resize selected object
- </td>
- </tr>
-
- <tr>
- <td>
- Shift|(+/-) orShift|(Home/End)
- </td>
- <td>
- Rotate selected object
- </td>
- </tr>
-
- <tr>
- <td>
- Most of the above actions with Alt key
- </td>
- <td>
- Slower change
- </td>
- </tr>
-
- </table>
-
- </blockquote>
-
-
-
-
- <p><b>Text Entry Fields</b></p>
-
-
- <p>Virtually all OpticalRayTracer's text entry fields can be changed by placing the mouse cursor over them and spinning the mouse wheel. If the rate of change is too fast, hold down the shift key while spinning the mouse. If that rate is also too fast, hold down the shift and Alt keys together while spinning the mouse.</p>
-
- <p>
- These actions can be gotten with some special keyboard keys also -- the up and down arrow keys will change the value by +1 and -1 respectively, with smaller changes if the shift and/or Alt keys are held down, just as with the mouse wheel example above. Here is a full list of these special controls:
- </p>
-
- <blockquote>
- <table cellspacing="-1" cellpadding="4" class="bordered">
-
- <tr>
- <th>
- Action
- </th>
- <th>
- Result
- </th>
- </tr>
-
- <tr>
- <td>
- Mouse wheel
- </td>
- <td>
- Value increased/decreased by 1
- </td>
- </tr>
-
- <tr>
- <td>
- up/down arrow keys
- </td>
- <td>
- Value increased/decreased by 1
- </td>
- </tr>
-
- <tr>
- <td>
- Page Up/Page Down keys
- </td>
-
- <td>
- Value increased/decreased by 10
- </td>
- </tr>
- <tr>
- <td>
- Home/End keys
- </td>
- <td>
- Value increased/decreased by 100
- </td>
-
- </tr>
- <tr>
- <td>
- Esc key
- </td>
- <td>
- Change sign (+-) of associated entry
- </td>
-
- </tr>
- </table>
-
- </blockquote>
-
- <p>The text-field mouse-wheel and keyboard actions listed above can be modified by these accompanying keystrokes:
- </p>
-
- <blockquote>
- <table cellspacing="-1" cellpadding="4" class="bordered">
- <tr>
- <th>
-
- Action
- </th>
- <th>
- Result
- </th>
- </tr>
- <tr>
- <td>
- Wheel/keyboard with Shift key
- </td>
- <td>
- Amount of change divided by 10
- </td>
- </tr>
-
- <tr>
- <td>
- Wheel/keyboard with Alt key
- </td>
- <td>
- Amount of change divided by 100
- </td>
- </tr>
- <tr>
- <td>
- Wheel/keyboard with both Shift and Alt keys
- </td>
- <td>
- Amount of change divided by 1000
- </td>
- </tr>
- </table>
-
- </blockquote>
-
-
-
- </blockquote>
-
- <a name="Importing_and_Exporting_Data"></a><div class="article_subtopic">Importing and Exporting Data</div>
-
-
- <blockquote>
-
- <p>OpticalRayTracer has a number of methods for writing and reading data to/from the world at large, primarily by way of the system clipboard.</p>
-
- <ul>
- <li>To create a copy of the specifications for a lens you've designed, simply click the lens, press the right mouse button and choose <img src="../icons/edit-copy.png" width="22" height="22" style="vertical-align:middle;" title="" alt=""/> "Copy".</li>
-
- <li>To paste that lens somewhere else, move the mouse cursor to the desired destination point, press the right mouse button and select <img src="../icons/edit-paste.png" width="22" height="22" style="vertical-align:middle;" title="" alt=""/> "Paste: mouse cursor."</li>
-
- <li>You can save lens descriptions in other locations, or even paste them into an e-mail for a friend, by pasting the lens description from the system clipboard. You can also make a copy of the entire experimental setup -- lenses, colors, zoom levels, everything -- by clicking the "Copy" button on the main toolbar below the graphic display (not the context-menu copy button). This places a full description of OpticalRayTracer's present state -- all the lenses and mirrors, plus pro [...]
-
- <li>To make a graphic copy of the workspace display, click the <img src="../icons/applications-multimedia.png" width="22" height="22" style="vertical-align:middle;" title="" alt=""/> "Copy Workspace" toolbar button, then open a graphic image editor and choose "Paste".</li>
-
- <li><p>To create a plain-text table of all the generated lines and place it on the system clipboard, click the <img src="../icons/document-save.png" width="22" height="22" style="vertical-align:middle;" title="" alt=""/> "Copy Table" toolbar button. The generated table can be easily imported into databases and spreadsheets. Note also that you can get information about individual lines by double-clicking the display near the line of interest. You can also use the line properties o [...]
-
-
- <p>Here's an example of an exported data table generated for a simple Newtonian reflector with three components -- a primary mirror, a diagonal reflector, and an eyepiece lens, all named for clarity:</p>
-
-
- <blockquote>
- <table cellspacing="-1" cellpadding="4" class="bordered">
-
- <tr><th>From</th><th>To</th><th>Source</th><th>Destination</th><th>DestinationType</th><th>FromX</th><th>FromY</th><th>ToX</th><th>ToY</th><th>DeltaX</th><th>DeltaY</th><th>Magnitude</th><th>BeamAngle</th><th>SurfaceNormalAngle</th><th>WavelengthNM</th></tr>
- <tr><td class = "lj">Beam Origin</td><td class = "lj">Reflection</td><td class = "lj">Origin Ray 1</td><td class = "lj">Primary Mirror</td><td class = "lj">Mirror</td><td >-30.0000</td><td >-1.8000</td><td >7.7244</td><td >-1.8000</td><td >37.7244</td><td >2.2204e-16</td><td >37.7244</td><td >3.3724e-16</td><td >173.4166</td><td >589.3000</td></tr>
- <tr><td class = "lj">Reflection</td><td class = "lj">Reflection</td><td class = "lj">Primary Mirror</td><td class = "lj">Diagonal Mirror</td><td class = "lj">Mirror</td><td >7.7244</td><td >-1.8000</td><td >1.2962</td><td >-0.2962</td><td >-6.4282</td><td >1.5038</td><td >6.6017</td><td >166.8332</td><td >-315.0002</td><td >589.3000</td></tr>
- <tr><td class = "lj">Reflection</td><td class = "lj">Refraction</td><td class = "lj">Diagonal Mirror</td><td class = "lj">Eyepiece Lens</td><td class = "lj">Lens</td><td >1.2962</td><td >-0.2962</td><td >0.6519</td><td >2.4582</td><td >-0.6443</td><td >2.7544</td><td >2.8288</td><td >103.1664</td><td >-102.5668</td><td >589.3000</td></tr>
- <tr><td class = "lj">Refraction</td><td class = "lj">Refraction</td><td class = "lj">Eyepiece Lens</td><td class = "lj">Eyepiece Lens</td><td class = "lj">Lens</td><td >0.6519</td><td >2.4582</td><td >0.6461</td><td >2.5405</td><td >-0.0058</td><td >0.0823</td><td >0.0825</td><td >94.0306</td><td >-77.2203</td><td >589.3000</td></tr>
- <tr><td class = "lj">Refraction</td><td class = "lj">Termination</td><td class = "lj">Eyepiece Lens</td><td class = "lj">Virtual space boundary</td><td class = "lj">Domain Limit</td><td >0.6461</td><td >2.5405</td><td >1.6467</td><td >100.0000</td><td >1.0006</td><td >97.4595</td><td >97.4646</td><td >89.4118</td><td >0.0000e+00</td><td >589.3000</td></tr>
- </table>
-
-
-
-
-
-
- </blockquote>
-
-
-
-
- </li>
-
- </ul>
- </blockquote>
-
- <a name="System_Considerations"></a><div class="article_subtopic">System Considerations</div>
-
- <blockquote>
-
- <p>Remember that OpticalRayTracer is a Java application, which means it needs a current Java runtime engine. If the behavior of your copy of OpticalRayTracer doesn't correspond with the description provided here, it probably means your installed version of Java is not up-to-date. To remedy this, visit <a href="http://java.com">http://java.com</a> to update your Java installation (Java is free).</p>
-
- <p>Remember also that the total number of beams traced is equal to the number of tracing beams (selected in the "Configuration" panel) multiplied by the number of dispersion beams, e. g. there is a dispersion beam for each chosen wavelength, times each tracing beam. So if the display slows down, this could easily be the reason -- too many beams selected. To prevent calculation of dispersion, simply set "Dispersion Beam Count" to zero.</p>
-
- </blockquote>
-
- <a name="Algorithm_Description"></a><div class="article_subtopic">Algorithm Description</div>
-
- <blockquote>
-
- (For a more complete presentation of this topic, visit the <a href="http://arachnoid.com/OpticalRayTracer_technical/index.html">OpticalRayTracer technical discussion page</a>.)
-
- <p>OpticalRayTracer first calculates the location of any intersections between tracing beams and spheres or hyperboloids (our lenses). The collision detection mathematics is rather involved and won't be described in any detail here.</p>
-
- <p>Having acquired a list of all possible points of collision for a particular beam, OpticalRayTracer sorts the list of results along the current direction, then determines which intersection is closest along the beam's path.</p>
-
- <p>At this point OpticalRayTracer has determined a point of collision between a tracing ray and a lens or mirror. The ray and the lens collision point each have a characteristic angle, which is used in the next computation.</p>
-
- </blockquote>
-
- <a name="Snell_s_Law"></a><div class="article_subtopic">Snell's Law</div>
-
- <blockquote>
- <p>"Snell's Law" is a classic optical relationship that, given arguments for incidence angle between two media and indices of refraction for the two media, determines the deflection angle. Expressed in classic form, Snell's Law is:</p>
-
- <blockquote>
- n1 sin(a1) = n2 sin(a2)
- </blockquote>
-
- <p>Where:</p>
-
- <ul>
- <li>n1 = index of refraction of medium 1</li>
- <li>a1 = angle within medium 1</li>
-
- <li>n2 = index of refraction of medium 2</li>
- <li>a2 = angle within medium 2</li>
- </ul>
-
- <p>The astute reader will notice that, in passing from a medium like air with an IOR near 1.0, to a lens with an IOR of 1.5 for example, the light beam's angle with repect to the surface normal must decrease. And conversely, a beam emerging from glass to air will show an increase in its angle of deflection. It can also be seen that an incident relative angle of zero will not be deflected -- it will remain zero.</p>
-
- <p>In computing refraction, OpticalRayTracer uses this restatement of the classic Snell's Law equation:</p>
-
- <blockquote>
- a2 = sin<sup>-1</sup>(sin(a1) n1 / n2)
- </blockquote>
-
- <p>Here's a practical example:</p>
-
-
-
- <ul>
- <li>Medium 1: air
-
- <ul>
- <li>n1 = 1.0</li>
- <li>a1 = 20 degrees</li>
- </ul>
- </li>
- <li>Medium 2: crown spectacle glass
-
- <ul>
- <li>n2 = 1.52</li>
- <li>a2 = sin<sup>-1</sup>(sin(a1) n1 / n2) = 13.00365 degrees</li>
- </ul>
- </li>
- </ul>
-
-
- <p>The above example (in which n1 < n2) causes the beam to deflect toward the normal line (the line perpendicular to the optical surface). In the reverse case (n1 > n2), the ray is deflected away from the normal line. In some cases this may exceed a "critical angle" such that the beam is deflected back into the refracting medium. This is called "total internal reflection", and in such a case OpticalRayTracer imitates nature by reflecting the beam back into the medium using a [...]
-
- <p>Note: OpticalRayTracer provides very reliable Snell's Law results, as accurate as the entered lens measurements. The values listed in the OpticalRaytracer data table can be relied on for optical analysis purposes within floating-point processing accuracy limitations.</p>
-
- </blockquote>
-
- <a name="Dispersion_Computation"></a><div class="article_subtopic">Dispersion Computation</div>
-
- <blockquote>
- <p>The computation for dispersion follows along similar lines, but this task is less open to analysis from physically simple principles. My empirical dispersion equation changes the index of refraction based on the wavelength of the light beam:</p>
-
-
-
- <blockquote>
- ior' = ior + ((dp - w) 5x10<sup>5</sup>) / (abbe dp w<sup>2</sup>)
- </blockquote>
-
- <p>Where:</p>
-
-
-
- <ul>
- <li>ior' = effective index of refraction at wavelength w</li>
-
- <li>ior = default index of refraction for the medium.</li>
-
- <li>dp = dispersion pivot wavelength, set to 589.3 nm, the sodium yellow line.</li>
-
- <li>w = wavelength of the tracing beam in nanometers.</li>
-
- <li>abbe = Abbe's Number, a value published for many glasses that describes its dispersion property. Lower Abbe's numbers result in higher dispersion.</li>
- </ul>
-
- <p>Abbe's Number is arrived at in this way:</p>
-
- <blockquote>
- abbe = (nd-1)/(nf-nc)
- </blockquote>
-
- <p>Where:</p>
-
- <ul>
- <li>nf = a medium's index of refraction at the 486.1 nm hydrogen blue line.</li>
- <li>nd = a medium's index of refraction at the 589.3 nm sodium yellow line.</li>
- <li>nc = a medium's index of refraction at the 656.3 nm hydrogen red line.</li>
- </ul>
-
- <p>Abbe numbers for various media are arrived at empirically in laboratory experiments. My equation reverses the relationship between the number and its effects, giving a dispersion-modified IOR with an accuracy of about 5% for many common glasses.</p>
-
- <p>Note: OpticalRayTracer provides <i>approximate</i> dispersion results, suitable for graphic display purposes but not precise (as explained <a href="http://arachnoid.com/OpticalRayTracer_technical/index.html#h14">here</a>). If very accurate results are required, a formal calculation is recommended.</p>
-
-
- </blockquote>
-
- <a name="Design_Options"></a><div class="article_subtopic">Design Options</div>
-
- <blockquote>
-
- <p>Here is a list of the <img src="../icons/applications-graphics.png" width="22" height="22" style="vertical-align:middle;" title="" alt=""/> <b>Design</b> tab options and their meanings.</p>
-
- <ul>
- <li>The <b>Name</b> field acceps a custom name for each optical component. A default name is provided, but for complex optical setups, this feature is a nice way to keep track of components. Also, when a table of tracing data is exported, the names are included to help clarify what might otherwise be a confusing list of numerical data.</li>
-
- <li>The <b>Symmetrical</b> checkbox specifies that the lens is symmetrical -- the left and right sides are the same. This simplifies configuration for a symmetrical lens becaue only one entry needs to be made for each property.</li>
-
- <li>The <b>Radius</b> entry specifies the distance between the center of a lens and its edge. This value is sometimes confused with the left and right Sphere Radius entries discussed below. The difference is that the sphere radii specify two imaginary spheres that construct the lens, while this entry specifies the lens size from center to edge.</li>
-
- <li>The <b>Thickness</b> entry specifies the left-to-right thickness of the main body of the lens, apart from its curvature. This entry allows lenses to have a thickness beyond their optical curvature, and is typical of real-world lenses.</li>
-
- <li>The <b>X and Y Position</b> entries specify the lens placement in the X (horizontal) and Y (vertical) dimensions. The user can also drag the mouse cursor on the lens image to change these entries.</li>
-
-
- <li>There are two entries, left and right, for these values:
-
- <p><ul>
- <li>The <b>Sphere Radius</b> entry specifies the radius of one of the two spheres from which this lens is constructed. See the explanation at the <a href="http://arachnoid.com/OpticalRayTracer_technical/index.html">OpticalRayTracer Technical Description</a> page.</li>
-
- <li>The <b>Curvature</b> text entry field accepts an entry for hyperbolic curve:
- <ul>
- <li>Briefly, the curvature factor represents the location of a plane that bisects a unit cone (a hyperbola can be thought of as a <a href="http://en.wikipedia.org/wiki/Conic_section">conic section</a>).</li>
- <li>A factor entry of zero positions the bisecting plane at the cone's apex, which produces a lens with a triangular profile, essentially a prism.</li>
- <li>Larger factor entries move away from the cone's apex and produce less extreme hyperbolic curvatures, and very large numbers (i.e. 1 x 10<sup>7</sup>) change the curvature from a hyperbola to a figure approximating a parabola.</li>
- <li>For tasks that require hyperbolic curvature, entries from 0 to about 100 represent a range of useful shapes.</li>
- <li>For an approximate parabolic curve, for example to design a telescope mirror, enter a number around 1 x 10<sup>7</sup>, the actual numeric value isn't as important as its size, since mathematically speaking, there's only one parabolic curve. Then adjust the size and focal length of the optical element with the usual controls.</li>
- </ul>
-
-
- </li>
-
- <li>The next entry option consists of three "radio buttons" that selects one of the available optical surface curvatures for each side of a lens or mirror -- <b>Spherical</b>, <b>Parabolic</b>, and <b>Hyperbolic</b>, details of which are discussed above.</li>
-
- </ul></p>
-
-
- <li>The <b>IOR</b> checkbox specifies the lens material's <a href="http://en.wikipedia.org/wiki/Refractive_index">index of refraction</a>, which is the ratio of the speed of light in the lens material compared to that in a vacuum.</li>
-
- <li>The <b>Dispersion</b> entry specifies the amount of <a href="http://en.wikipedia.org/wiki/Dispersion_(optics)">dispersion</a> (a wavelength-dependent property) the lens material possesses.</li>
-
- <li>The <b>Angle</b> entry rotates the lens or mirror in the X/Y plane. This is useful for evaluating the off-axis behavior of a lens, and for setting up complex optical configurations, for example by directing beams using angled mirrors. </li>
- <li>The <b>Active</b> checkbox includes or excludes its associated component in the optical calculation. This is a convenient way to manage complex optical models and interactions -- using this feature one can place multiple components in the same location or path and easily switch between them.</li>
-
- <li>As explained above, OpticalRayTracer supports three kinds of optical objects: Refractors, Reflectors and Absorbers:
- <ul>
- <li>The <b>Refract</b> option is the default choice for lenses. Rays that intersect with this object will be refracted using the outcome of a Snell's Law calculation.</li>
- <li>The <b>Reflect</b> option turns a lens into a mirror. Light beams reflect from the lens' surfaces instead of passing through. This option makes it possible to create optical designs with mirrors, including curved mirrors such as one finds in modern telescopes.</li>
- <li>The <b>Absorb</b> option causes intersecting rays to be absorbed and terminated. This is a convenient way to create a barrier against certain rays that would interfere with a desired result. As with lenses and mirrors, an absorber can be given any desired size or shape.</li>
- </ul>
- </li>
-
-
- </li>
-
-
- </ul>
-
-
-
-
- </blockquote>
-
- <a name="Configuration_Options"></a><div class="article_subtopic">Configuration Options</div>
-
- <blockquote>
-
- <p>Here is an explanation of the controls in the <img src="../icons/applications-accessories.png" width="22" height="22" style="vertical-align:middle;" title="" alt=""/> <b>Configure</b> tab:</p>
-
- <ul>
- <li>First, the <b>Color</b> button bar:
- <p><ul>
- <li>To change a color in the <b>Configure</b> tab's selection list, simply click the colored button for the value you want to change (each button has a flyout explanation that appears when you hover the mouse cursor over the button). A color selection dialog will appear.</li>
-
- <li>OpticalRayTracer supports color transparency, which means if you adjust the "Alpha" setting in the color selection dialog, OpticalRaytracer will honor your choice and make the associated color transparent in proportion (in this context, "Alpha" means transparency). This is useful in a number of situations, for example when light beams overlap and obscure each other -- when the light beams are transparent, it's easier to find a true focal point.</li>
-
- <li><b>Light Source Bar Color</b>. This is the color of the vertical line that marks the light beam origin.</li>
-
- <li><b>X/Y Zero Baseline Color</b>. This is the color of the reference lines that appear at x = 0 and y = 0 in the ray trace display. If you do not want these lines to appear, set their color to the color of the display background (see "Display Background" below).</li>
-
- <li><b>Grid Color</b>. This is the auto-scaling grid in the ray trace display. Again, you can turn this off by setting its color to that of the background.</li>
-
- <li><b>Lens</b> color. This color is used to draw the profile and interior of each lens when not selected.</li>
-
- <li><b>Tracing Beams Color</b>. This is the beam color used when dispersion is not being computed. Remember that dispersion beams have an internally computed color, appropriate to their wavelength.</li>
-
- <li><b>Beam Intersection Color</b>. This is the color of the arrows that mark the intersections between light beams and lens surfaces, where beams change direction by way of refraction.</li>
-
- <li><b>Selected Lens Color</b>. A lens changes to this color when it has been selected for editing, either by clicking the lens directly or by way of the cycle lens toolbar button.</li>
-
- <li><b>Display High Background Color</b>. This color defaults to white, but in some cases, like trying to make out the color of dispersion beams, another color might be better.</li>
-
- <li><b>Display Low Background Color</b>. This color defaults to black, but the user has the option of choosing a different color.</li>
- </ul></p>
-
- </li>
-
- <li><b>Intersection Arrow Size</b>. This numeric entry specifies the size of the arrows that mark the destination points of light beams. To remove the arrows from the display, set this value to zero.</li>
-
- <li><b>Snap to grid value</b>. This numeric entry sets the threshold for the behavior that returns a lens to the X and Y grid when the mouse is released. This is ordinarily a good thing, a feature, but if you prefer this not to happen, set this number to zero to disable the feature, or choose a different value for special purposes.</li>
-
- <li><b>Beam width</b>. This setting adjusts the width of all image lines. An entry of zero is ignored, the minimum beam width is 1.</li>
-
- <li><b>Light beam count</b>. This is a setting with a large impact on program performance. OpticalRayTracer's algorithms are swift, but choosing a large number of tracing beams might disable one of its best features: real-time response to user inputs. Also, it is easy to become overloaded with information as the number of beams increases. It is difficult to take advantage of the information presented by more than about 8 tracing beams. Lots of beams can be entertaining, though.</li>
-
- <li><b>Source Y start and end</b>. These values determine the vertical limits for the array of tracing beams. These two numbers are typically set to fall within the chosen radius of your lenses. The default settings of -1.8 and 1.8 means all the beams fall comfortably within the default lens radius of 2 units (remember that a lens diameter is twice its radius).</li>
-
- <li><b>Maximum interactions</b>. This determines the limit to interactions for a given beam, to avoid the computation of pointless internal reflections within a lens, for example. The default value is quite large, but a sufficiently complex lens system might require that it be increased.</li>
-
- <li><b>X Source plane</b>. This is the location in the x dimension from which the tracing beams emanate. In the ray trace display, zoom out to see the location of the beam origin, then change this number to see what happens.</li>
-
- <li><b>X beam rotation plane</b>. This is the plane in the x dimension that represents the pivot point for beam rotation. If an entry is made for beam offset angle below, this will be the plane around which the beams will rotate. The default is zero, and for a specific off-axis lens test, the user has the option of moving the lens to this location, changing this defined plane to be that of the lens, or rotating the lens instead of the beams.</li>
-
- <li><b>Beam offset angle</b>. This setting is used to tilt the array of tracing beams, a way to test the off-axis performance of a lens without having to rotate the lens itself. By controlling the source angle you can observe the resulting path through a series of lenses, thus determining the off-axis performance for the entire system.</li>
-
- <li><b>Dispersion beam count</b>. This setting produces a set of dispersion beams, with appropriate colors and wavelengths, for each tracing beam. These dispersion beams will be deflected by different amounts depending on specific lens settings, in particular the dispersion value. This is the key to the dispersion effect simulation.</li>
-
- <li><b>Interlens epsilon</b>. This setting creates a threshold to distinguish between optical surfaces. If during calculation two surfaces are found to be separated by a small distance, OpticalRayTracer may assume the source and destination are the same surface -- and that may be true. To prevent this from happening, increase this setting. Most OpticalRayTracer numerical entries are large, but this one is normally very small, such that scientific notation is normally used, for ex [...]
-
- <li><b>Surface epsilon</b>. This value creates an acceptance boundary around optical objects so the ray tracer can identify and interact with them. If a light ray skips over a legitimate object instead of interacting with it, increase this value. If light rays seem to be interacting with the empty space near lenses, decrease this value. In nearly all cases this setting's default value shouldn't need to be changed.</li>
-
- <li><b>Virtual space box size</b>. This is an outer limit size for the OpticalRayTracer virtual space. This value prevents anomalous behavior that can result from overly large computation values in the absence of limits.</li>
-
- <li><b>Diverging Beams</b>. This checkbox causes the tracing beams to originate in and diverge from a point source located at the X source reference plane, rather than being generated in parallel at that plane.</li>
- </ul>
-
- <p>Remember that all the above values are reset by the <img src="../icons/process-stop.png" width="22" height="22" style="vertical-align:middle;" title="" alt=""/> Erase & Reset button. If you make settings that cause problems, simply reset the program to its default values.</p>
-
-
- <p>Remember also that the total number of ray trace computations is equal to the number of tracing beams multiplied by the number of dispersion beams, such that choosing 8 tracing beams and 8 dispersion beams results in 64 traces, fine for a fast computer, but not so great for a slower machine. To prevent the generation of dispersion beams and their associated computation overhead, set this value to zero.</p>
-
-
- <p>All the configuration values, along with a full description of the lenses you create, are preserved between sessions in a file located at #userdir#/OpticalRayTracer.ini on this system, and the same information can be copied onto the system clipboard with the toolbar "Copy Configuration" button.</p>
-
-
- </blockquote>
-
- <a name="Introduction"></a><div class="article_subtopic">Common Problems</div>
-
-
-
- <ul>
- <li>When designing systems of lenses, be sure that your lenses do not overlap, that one lens is not located within another, and that the light source is not located within a lens. In short, <i>the light source must be separate from the lenses, and and the lenses must be separate from each other</i>.</li>
- <li>If light beams pass through lens surfaces without any interaction, this may result from a <b>Surface Epsilon</b> value (on the <img src="../icons/applications-accessories.png" width="22" height="22" style="vertical-align:middle;" title="" alt=""/> Configure tab) that is too small for the scale of the lenses -- try increasing this value.</li>
- </ul>
-
-
-
- <a name="Conclusion"></a><div class="article_subtopic">Conclusion</div>
-
- <blockquote>
- <p>The OpticalRayTracer Home Page is located at <a href="http://www.arachnoid.com/OpticalRayTracer">http://www.arachnoid.com/OpticalRayTracer</a>, where additional documentation and other resources are located. Be sure to visit to make sure you have the latest version of OpticalRayTracer.</p>
-
-
-
- <p>There is a great deal of excellent, detailed information about optics on the Web, both theoretical and practical. Google for "optics," "ray tracing" and related topics.</p>
-
-
- </blockquote>
-
- <a name="User_support"></a><div class="article_subtopic">User support</div>
-
- <blockquote>
-
- <p><a href="http://arachnoid.com/OpticalRayTracer_technical/index.html">Click here</a> for a more detailed technical description of OpticalRayTracer and optical mathematics in general.</p>
-
- <p>Because OpticalRayTracer is released under the <a href="http://www.gnu.org/copyleft/gpl.html">GPL</a> (but please visit <a href="http://www.arachnoid.com/careware">Careware</a> anyway), there is no user support. This help file plus the sort of knowledge available in optical textbooks and online should be sufficient to help the user make it productive.</p>
-
- <p>If you detect a bug in OpticalRayTracer, please report it at <a href="http://www.arachnoid.com/messages">arachnoid.com Messages</a>.</p>
-
-
- </blockquote>
- </body>
-</html>
--
Alioth's /usr/local/bin/git-commit-notice on /srv/git.debian.org/git/debian-science/packages/opticalraytracer.git
More information about the debian-science-commits
mailing list