Vincolo di Rifrazione

From FreeCAD Documentation
Revision as of 22:06, 13 January 2015 by Renatorivo (talk | contribs) (Created page with "==Scripting== I vincoli possono essere creati con le macro e dalla console di Python utilizzando la seguente funzione:")

Rifrazione

Posizione nel menu
Sketch → Sketcher Constraints → Rifrazione (Legge di Snell)
Ambiente
Sketcher, PartDesign
Avvio veloce
Nessuno
Introdotto nella versione
-
Vedere anche
Nessuno

Descrizione

Vincola due linee a disporsi secondo la legge della rifrazione di un raggio di luce che attraversa un'interfaccia, ovvero nella transizione tra due materiali con differenti indici di rifrazione. Per maggiori informazioni si può consultare la pagina sulla Legge di Snell di Wikipedia.

Snell's law

Uso

Le frecce gialle con i numeri indicano la sequenza dei punti da cliccare. Le etichette n1 e n2 di questa immagine servono per mostrare dove si trovano gli indici di rifrazione.
  • Servono due linee che rappresentino un raggio di luce e una curva che funga da interfaccia. Le linee devono essere su lati diversi dell'interfaccia.
  • Selezionare l'estremità di una linea, il punto finale di un'altra linea e il bordo dell'interfaccia. L'interfaccia può essere una linea, un cerchio, un arco, una ellisse o un arco di ellisse. Stare attenti all'ordine di selezione dei punti finali.
  • Richiamare il vincolo. Appare una finestra di dialogo in cui si deve indicare il rapporto tra gli indici di rifrazione n2/n1. L'indice n2 si riferisce al mezzo in cui risiede la linea del secondo punto finale selezionato, n1 si riferisce alla prima linea.
  • Prima di applicare il vincolo legge di Snell, i punti finali devono essere resi coincidenti e vincolati sull'interfaccia, se non lo sono.

Notare che ci sono diversi autovincoli addizionali (punto-su-oggetto, coincidenza, ecc.) e che essi possono essere eliminati se causano la ridondanza, o essere aggiunti manualmente se non sono stati aggiunti automaticamente. Per l'attuale vincolo di Rifrazione, i punti finali delle linee devono coincidere e trovarsi sull'interfaccia, altrimenti il suo comportamento è imprevedibile.

Utilizzando lo strumento polilinea, è possibile velocizzare il disegno dei raggi di luce. In questo caso, è possibile selezionare due punti finali coincidenti con il rettangolo di selezione.

Osservazioni

  • L'attuale vincolo Legge di Snell usa l'equazione per un piano n1*sin(theta1) = n2*sin(theta2). I punti terminali devono essere resi coincidenti e posizionati sul'interfaccia usando altri vincoli. I vincoli di supporto necessari vengono aggiunti automaticamente in base alle correnti coordinate degli elementi.
  • Python non aggiunge automaticamente i vincoli di supporto. Essi devono essere aggiunti manualmente con lo script (vedere l'esempio nella sezione Scripting).
  • I vincoli di supporto possono essere eliminati temporaneamente per consentire di spostare i punti finali, questo può essere utile nel caso in cui si voglia realizzare un raggio riflesso o dei raggi birifrangenza.
  • Diversamente dalla realtà, gli indici di rifrazione sono associati ai raggi di luce, ma non ai lati del contorno. Ciò è utile per emulare birifrangenza, costruire percorsi di diverse lunghezze d'onda dovuti alla rifrazione, e costruire facilmente l'angolo di insorgenza della riflessione interna totale.
  • Entrambi i raggi possono essere sullo stesso lato dell'interfaccia, e soddisfare comunque l'equazione del vincolo. Questo è un non senso fisico, a meno che il rapporto n2 / n1 sia 1.0, nel qual caso il vincolo emula un riflesso.
  • Come raggi sono accettati anche gli archi di cerchio e di ellisse (non senso fisico).

Scripting

I vincoli possono essere creati con le macro e dalla console di Python utilizzando la seguente funzione:

Sketch.addConstraint(Sketcher.Constraint('SnellsLaw',line1,pointpos1,line2,pointpos2,interface,n2byn1))

where:

  • Sketch is a sketch object
  • line1 and pointpos1 are two integers identifying the endpoint of the line in medium with refractive index of n1. line1 is the line's index in the sketch (the value, returned by Sketch.addGeometry), and pointpos1 should be 1 for start point and 2 for end point.
  • line2 and pointpos2 are the indexes specifying the endpoint of the second line (in medium n2)
  • n2byn1 is a floating-point number equal to the ratio of refractive indices n2/n1

Example:

from Sketcher import *
from Part import *
from FreeCAD import *

StartPoint = 1
EndPoint = 2
MiddlePoint = 3

f = App.activeDocument().addObject("Sketcher::SketchObject","Sketch")

# add geometry to the sketch
icir = f.addGeometry(Part.Circle(App.Vector(-547.612366,227.479736,0),App.Vector(0,0,1),68.161979))
iline1 = f.addGeometry(Part.Line(App.Vector(-667.331726,244.127090,0),App.Vector(-604.284241,269.275238,0)))
iline2 = f.addGeometry(Part.Line(App.Vector(-604.284241,269.275238,0),App.Vector(-490.940491,256.878265,0)))
# add constraints
# helper constraints:
f.addConstraint(Sketcher.Constraint('Coincident',iline1,EndPoint,iline2,StartPoint)) 
f.addConstraint(Sketcher.Constraint('PointOnObject',iline1,EndPoint,icir)) 
# the Snell's law:
f.addConstraint(Sketcher.Constraint('SnellsLaw',iline1,EndPoint,iline2,StartPoint,icir,1.47))

App.ActiveDocument.recompute()

Version

The constraint was introduced in FreeCAD v0.15.4387