Sketcher ConstrainSnellsLaw/it: Difference between revisions

From FreeCAD Documentation
(Created page with "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 manual...")
(Updating to match new version of source page)
(40 intermediate revisions by 3 users not shown)
Line 1: Line 1:
<languages/>
{{GuiCommand/it|Name=Constraint SnellsLaw|Name/it=Rifrazione|MenuLocation=Sketch → Sketcher Constraints → Rifrazione (Legge di Snell)|Workbenches=[[Sketcher Workbench/it|Sketcher]], [[PartDesign Workbench/it|PartDesign]]}}
<div class="mw-translate-fuzzy">
{{Docnav/it|[[Sketcher_ConstrainAngle/it|Angolo interno]]|[[Sketcher_ConstrainInternalAlignment/it|Allineamento interno]]|[[Sketcher_Workbench/it|Sketcher]]|IconL=Constraint_InternalAngle.png|IconC=Workbench_Sketcher.svg|IconR=Constraint_InternalAlignment.png }}
</div>

<div class="mw-translate-fuzzy">
{{GuiCommand/it
|Name=Constraint SnellsLaw
|Name/it=Rifrazione
|MenuLocation=Sketch → Sketcher Constraints → Rifrazione (Legge di Snell)
|Workbenches=[[Sketcher Workbench/it|Sketcher]]
|Version=0.15
}}
</div>

==Descrizione==


<div class="mw-translate-fuzzy">
==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 [http://http://it.wikipedia.org/wiki/Legge_di_Snell Legge di Snell] di Wikipedia.
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 [http://http://it.wikipedia.org/wiki/Legge_di_Snell Legge di Snell] di Wikipedia.
[[Image:Snells law2 witheq.svg|thumb|left|200px|Snell's law]]
[[Image:Snells law2 witheq.svg|thumb|left|200px|Snell's law]]
{{clear}}
{{clear}}
</div>


[[File:Snells_law2_witheq.svg|x400px]]
==Uso==
[[Image:Sketcher SnellsLaw Example1.png|thumb|none|500px|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.]]


{{Caption|Snell's Law}}

==Utilizzo==

<div class="mw-translate-fuzzy">
[[Image:Sketcher SnellsLaw Example1.png|thumb|none|500px|Le frecce gialle con i numeri indicano la sequenza dei punti da cliccare. n1 e n2 di questa immagine sono solo etichette che servono per mostrare dove si trovano gli indici di rifrazione.]]
</div>

{{Caption|The sequence of clicks is indicated by yellow arrows with numbers. n1, n2 are only labels to show where the indices of refraction are.}}

<div class="mw-translate-fuzzy">
* 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.
* 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.
* 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.
* 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.
* I punti finali possono essere resi prima coincidenti e vincolati sull'interfaccia (se è necessario), e poi vincolati secondo la legge di Snell.
* Prima di applicare il vincolo legge di Snell, i punti finali devono essere resi coincidenti e vincolati sull'interfaccia, se non lo sono.
</div>


<div class="mw-translate-fuzzy">
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.
Notare che ci sono diversi [[Sketcher helper constraint/it|autovincoli]] che vengono aggiunti automaticamente (punto-su-oggetto, coincidenza, ecc.). 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.
</div>


<div class="mw-translate-fuzzy">
Using polyline tool, it is possible to speedup drawing of rays of light. In this case, one can select two coincident endpoints by box selection.
Utilizzando lo strumento [[Sketcher_CreatePolyline/it|polilinea]] [[Image:Sketcher_CreatePolyline.svg|24px]], è possibile velocizzare il disegno dei raggi di luce. In questo caso, è possibile selezionare due punti finali coincidenti con il rettangolo di selezione.
</div>


==Remarks==
==Remarks==

* The actual Snell's law constraint enforces the plain law equation n1*sin(theta1) = n2*sin(theta2). It needs the line ends to be made coincident and on the interface by other constraints. The necessary helper constraints are added automatically based on the current coordinates of the elements.
<div class="mw-translate-fuzzy">
* Python routine does not add the helper constraints. These must be added manually by the script (see example in Scripting section).
==Osservazioni==
* These helper constraints can be temporarily deleted and the endpoints dragged apart, which can be useful in case one wants to construct a reflected ray or birefringence rays.
* 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.
* Unlike the reality, refraction indices are associated with rays of light, but not according to the sides of the boundary. This is useful to emulate birefringence, construct paths of different wavelengths due to refraction, and easily construct angle of onset of total internal reflection.
* Python non aggiunge automaticamente i vincoli di supporto. Essi devono essere aggiunti manualmente con lo script (vedere l'esempio nella sezione Scripting).
* Both rays can be on the same side of the interface, satisfying the constraint equation. This is physical nonsense, unless the ratio n2/n1 is 1.0, in which case the constraint emulates a reflection.
* 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.
* Arcs of circle and ellipse are also accepted as rays (physical nonsence).
* 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).
</div>


==Scripting==
==Scripting==

The constraints can be created from [[macros]] and from the python console by using the following function:
<div class="mw-translate-fuzzy">
==Scripting==
I vincoli possono essere creati con le [[macros/it|macro]] e dalla [[FreeCAD_Scripting_Basics/it|console di Python]] utilizzando la seguente funzione:
</div>
{{Code|code=
{{Code|code=
Sketch.addConstraint(Sketcher.Constraint('SnellsLaw',line1,pointpos1,line2,pointpos2,interface,n2byn1))
Sketch.addConstraint(Sketcher.Constraint('SnellsLaw',line1,pointpos1,line2,pointpos2,interface,n2byn1))
}}
}}
Dove:
where:
:* <tt>Sketch</tt> is a sketch object
:* <tt>Sketch</tt> è un oggetto sketch
:* <tt>line1</tt> and <tt>pointpos1</tt> are two integers identifying the endpoint of the line in medium with refractive index of ''n1''. <tt>line1</tt> is the line's index in the sketch (the value, returned by Sketch.addGeometry), and <tt>pointpos1</tt> should be 1 for start point and 2 for end point.
:* <tt>line1</tt> e <tt>pointpos1</tt> sono due numeri interi che indicano il punto finale della linea nel mezzo con l'indice di rifrazione ''n1''. <tt>line1</tt> è l'indice della linea nello sketch (il valore, restituito da Sketch.addGeometry), e <tt>pointpos1</tt> dovrebbe essere 1 per il punto iniziale e 2 per il punto finale.
:* <tt>line2</tt> and <tt>pointpos2</tt> are the indexes specifying the endpoint of the second line (in medium ''n2'')
:* <tt>line2</tt> e <tt>pointpos2</tt> sono gli indici che specificano i punti della seconda linea (nel mezzo ''n2'')
:* <tt>n2byn1</tt> is a floating-point number equal to the ratio of refractive indices ''n2''/''n1''
:* <tt>n2byn1</tt> è un numero a virgola mobile dato dal rapporto tra gli indici di rifrazione ''n2''/''n1''


Esempio:
Example:
{{Code|code=
{{Code|code=
from Sketcher import *
import Sketcher
from Part import *
import Part
from FreeCAD import *
import FreeCAD


StartPoint = 1
StartPoint = 1
Line 51: Line 90:
# add geometry to the 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))
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)))
iline1 = f.addGeometry(Part.LineSegment(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)))
iline2 = f.addGeometry(Part.LineSegment(App.Vector(-604.284241,269.275238,0),App.Vector(-490.940491,256.878265,0)))
# add constraints
# add constraints
# helper constraints:
# helper constraints:
Line 60: Line 99:
f.addConstraint(Sketcher.Constraint('SnellsLaw',iline1,EndPoint,iline2,StartPoint,icir,1.47))
f.addConstraint(Sketcher.Constraint('SnellsLaw',iline1,EndPoint,iline2,StartPoint,icir,1.47))


App.ActiveDocument.recompute()}}
App.ActiveDocument.recompute()
}}


==Version==
The constraint was introduced in FreeCAD v0.15.4387


<div class="mw-translate-fuzzy">
{{Docnav/it|[[Sketcher_ConstrainAngle/it|Angolo interno]]|[[Sketcher_ConstrainInternalAlignment/it|Allineamento interno]]|[[Sketcher_Workbench/it|Sketcher]]|IconL=Constraint_InternalAngle.png|IconC=Workbench_Sketcher.svg|IconR=Constraint_InternalAlignment.png }}
</div>

{{Sketcher Tools navi{{#translation:}}}}
{{Userdocnavi{{#translation:}}}}
{{clear}}
{{clear}}
<languages/>

Revision as of 16:14, 30 December 2020

Rifrazione

Posizione nel menu
Sketch → Sketcher Constraints → Rifrazione (Legge di Snell)
Ambiente
Sketcher
Avvio veloce
Nessuno
Introdotto nella versione
0.15
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

Snell's Law

Utilizzo

Le frecce gialle con i numeri indicano la sequenza dei punti da cliccare. n1 e n2 di questa immagine sono solo etichette che servono per mostrare dove si trovano gli indici di rifrazione.

The sequence of clicks is indicated by yellow arrows with numbers. n1, n2 are only labels to show where the indices of refraction are.

  • 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 che vengono aggiunti automaticamente (punto-su-oggetto, coincidenza, ecc.). 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.

Remarks

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

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))

Dove:

  • Sketch è un oggetto sketch
  • line1 e pointpos1 sono due numeri interi che indicano il punto finale della linea nel mezzo con l'indice di rifrazione n1. line1 è l'indice della linea nello sketch (il valore, restituito da Sketch.addGeometry), e pointpos1 dovrebbe essere 1 per il punto iniziale e 2 per il punto finale.
  • line2 e pointpos2 sono gli indici che specificano i punti della seconda linea (nel mezzo n2)
  • n2byn1 è un numero a virgola mobile dato dal rapporto tra gli indici di rifrazione n2/n1

Esempio:

import Sketcher
import Part
import FreeCAD

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.LineSegment(App.Vector(-667.331726,244.127090,0),App.Vector(-604.284241,269.275238,0)))
iline2 = f.addGeometry(Part.LineSegment(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()