Sketcher ConstrainSnellsLaw/it: Difference between revisions

From FreeCAD Documentation
(Created page with "==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 c...")
No edit summary
(31 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]]}}
{{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 }}

{{GuiCommand/it
|Name=Constraint SnellsLaw
|Name/it=Rifrazione
|MenuLocation=Sketch → Sketcher Constraints → Rifrazione (Legge di Snell)
|Workbenches=[[Sketcher Workbench/it|Sketcher]]
|Version=0.15
}}


==Descrizione==
==Descrizione==
Line 6: Line 15:
{{clear}}
{{clear}}


==How to use==
==Utilizzo==
[[Image:Sketcher SnellsLaw Example1.png|thumb|none|500px|The sequence of clicks is indicated by yellow arrows with numbers. n1, n2 are labeles on this picture to show where the indices of refraction are.]]
[[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.]]


* 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.
* You'll need two lines that are to follow a beam of light, and a curve to act as an interface. The lines should be on different sides of the interface.
* 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.
* Select the endpoint of one line, an endpoint of another line, and the interface edge. The interface can be a line, circle/arc, ellipse/arc of ellipse. Note the order you've selected the endpoints.
* 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.
* Invoke the constraint. A dialog will appear asking for a ratio of indices of refraction n2/n1. n2 corresponds to the medium where the second selected endpoint's line resides, n1 is for the first line.
* Prima di applicare il vincolo legge di Snell, i punti finali devono essere resi coincidenti e vincolati sull'interfaccia, se non lo sono.
* The endpoints will be made coincident (if needed), constrained onto the interface (if needed), and the Snell's law will become constrained.


Notare che ci sono diversi [[Sketcher helper constraint/it|autovincoli]] (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.
Note that there are several helper constraints smart-added (point-on-object, coincident), and they can be deleted if they cause redundancy, or added manually if they were not added automatically. For the actual Snell's law constraint, the endpoints of lines must coincide and lie on the interface, otherwise the behavior is undefined.


Utilizzando lo strumento [[Sketcher_CreatePolyline/it|polilinea]] [[Image:Sketcher_CreatePolyline.png|24px]], è possibile velocizzare il disegno dei raggi di luce. In questo caso, è possibile selezionare due punti finali coincidenti con il rettangolo di selezione.
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.


==Remarks==
==Osservazioni==
* 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.
* 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 routine does not add the helper constraints. These must be added manually by the script (see example in Scripting section).
* 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.
* 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.
* 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.
* 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.
* 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.
* 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.
* Come raggi sono accettati anche gli archi di cerchio e di ellisse (non senso fisico).
* Arcs of circle and ellipse are also accepted as rays (physical nonsence).


==Scripting==
==Scripting==
I vincoli possono essere creati con le [[macros/it|macro]] e dalla [[FreeCAD_Scripting_Basics/it|console di Python]] utilizzando la seguente funzione:
The constraints can be created from [[macros]] and from the python console by using the following function:
{{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 60:
# 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 69:
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==
==Versione==
The constraint was introduced in FreeCAD v0.15.4387
Questo vincolo è stato introdotto in FreeCAD v0.15.4387

{{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 }}

{{Sketcher Tools navi/it}}

{{Userdocnavi/it}}


{{clear}}
{{clear}}
<languages/>

Revision as of 22:07, 15 February 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

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.
  • 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 (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))

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

Versione

Questo vincolo è stato introdotto in FreeCAD v0.15.4387