`matplotlib.patheffects`#

Define clases para efectos de ruta. Los efectos de ruta son compatibles con Text, Line2Dy Patch.

Ver también

Guía de efectos de ruta

clase matplotlib.patheffects. AbstractPathEffect ( desplazamiento = (0.0, 0.0) ) [fuente] #

Bases:object

Una clase base para efectos de ruta.

Las subclases deben anular el draw_pathmétodo para agregar la funcionalidad del efecto.

Parámetros :

desplazamiento (flotante, flotante), predeterminado: (0, 0): El desplazamiento (x, y) que se aplicará a la ruta, medido en puntos.

draw_path ( procesador , gc , tpath , afín , rgbFace = Ninguno ) [fuente] #: Derivado debe anular este método. Los argumentos son los mismos que matplotlib.backend_bases.RendererBase.draw_path() excepto que el primer argumento es un renderizador.

clase matplotlib.patheffects. Normal ( desplazamiento = (0.0, 0.0) ) [fuente] #

Bases:AbstractPathEffect

La "identidad" PathEffect.

El único propósito de Normal PathEffect es dibujar al artista original sin un efecto de ruta especial.

Parámetros :

desplazamiento (flotante, flotante), predeterminado: (0, 0): El desplazamiento (x, y) que se aplicará a la ruta, medido en puntos.

clase matplotlib.patheffects. PathEffectRenderer ( path_effects , renderer ) [fuente] #

Bases:RendererBase

Implementa un Renderer que contiene otro renderer.

Este proxy luego intercepta las llamadas de sorteo, llamando al AbstractPathEffectmétodo de sorteo apropiado.

Nota

No todos los métodos han sido anulados en esta subclase RendererBase. Puede ser necesario agregar más métodos para ampliar aún más las capacidades de PathEffects.

Parámetros :

path_effects iterable deAbstractPathEffect: Los efectos de ruta que representa este renderizador.
subclase de renderizadormatplotlib.backend_bases.RendererBase

copy_with_path_effect ( path_effects ) [fuente] #

dibujar_marcadores ( gc , marcador_ruta , marcador_trans , ruta , * argumentos , ** kwargs ) [fuente] #

Dibuja un marcador en cada uno de los vértices de la ruta (excluyendo los puntos de control).

La implementación base (alternativa) realiza varias llamadas a draw_path. Es posible que los backends deseen anular este método para dibujar el marcador solo una vez y reutilizarlo varias veces.

Parámetros :

gcGraphicsContextBase: El contexto gráfico.
marcador_transmatplotlib.transforms.Transform: Una transformación afín aplicada al marcador.
transmatplotlib.transforms.Transform: Una transformación afín aplicada a la ruta.

draw_path ( gc , tpath , affine , rgbFace = Ninguno ) [fuente] #: Dibuja una Pathinstancia usando la transformación afín dada.

draw_path_collection ( gc , master_transform , paths , * args , ** kwargs ) [fuente] #

Dibuja una colección de caminos .

Cada ruta se transforma primero por la entrada correspondiente en all_transforms (una lista de (3, 3) matrices) y luego por master_transform . Luego se traducen por la entrada correspondiente en compensaciones , que primero ha sido transformada por compensaciones_trans .

facecolors , edgecolors , linewidths , linestyles y antialiased son listas que establecen las propiedades correspondientes.

offset_position no se usa ahora, pero el argumento se mantiene por compatibilidad con versiones anteriores.

La implementación base (alternativa) realiza varias llamadas a draw_path. Es posible que los backends deseen anular esto para representar cada conjunto de datos de ruta solo una vez y luego hacer referencia a esa ruta varias veces con los diferentes desplazamientos, colores, estilos, etc. Los métodos del generador _iter_collection_raw_pathsse _iter_collectionproporcionan para ayudar con (y estandarizar) la implementación a través de backends. Se recomienda encarecidamente usar esos generadores, para que los cambios en el comportamiento draw_path_collectionse puedan realizar globalmente.

clase matplotlib.patheffects. PathPatchEffect ( desplazamiento = (0, 0) , ** kwargs ) [fuente] #

Bases:AbstractPathEffect

Dibuja una PathPatchinstancia cuyo Path proviene del artista PathEffect original.

Parámetros :

desplazamiento (flotante, flotante), predeterminado: (0, 0): El desplazamiento (x, y) que se aplicará a la ruta, en puntos.
**kwargs: Todos los argumentos de palabras clave se pasan al PathPatchconstructor. Las propiedades que no se pueden anular son "ruta", "clip_box", "transform" y "clip_path".

draw_path ( procesador , gc , tpath , afín , rgbFace ) [fuente] #: Derivado debe anular este método. Los argumentos son los mismos que matplotlib.backend_bases.RendererBase.draw_path() excepto que el primer argumento es un renderizador.

clase matplotlib.patheffects. SimpleLineShadow ( offset = (2, -2) , shadow_color = 'k' , alpha = 0.3 , rho = 0.3 , ** kwargs ) [fuente] #

Bases:AbstractPathEffect

Una simple sombra a través de una línea.

Parámetros :

desplazamiento (flotante, flotante), por defecto: (2, -2): El desplazamiento (x, y) que se aplicará a la ruta, en puntos.
shadow_color color, por defecto: 'negro': El color de la sombra. Un valor de Nonetoma el color del artista original con un factor de escala de rho .
flotante alfa , predeterminado: 0.3: La transparencia alfa del parche de sombra creado.
rho flotante, por defecto: 0.3: Un factor de escala para aplicar al color rgbFace si shadow_color es None.
**kwargs: Las palabras clave adicionales se almacenan y pasan a AbstractPathEffect._update_gc().

draw_path ( procesador , gc , tpath , afín , rgbFace ) [fuente] #: Anula el draw_path estándar para agregar el desplazamiento de la sombra y los cambios de color necesarios para la sombra.

clase matplotlib.patheffects. SimplePatchShadow ( offset = (2, -2) , shadow_rgbFace = Ninguno , alfa = Ninguno , rho = 0.3 , ** kwargs ) [fuente] #

Bases:AbstractPathEffect

Una sombra simple a través de un parche relleno.

Parámetros :

desplazamiento (flotante, flotante), por defecto: (2, -2): El desplazamiento (x, y) de la sombra en puntos.
shadow_rgbColor de la cara: El color de la sombra.
flotante alfa , predeterminado: 0.3: La transparencia alfa del parche de sombra creado.
rho flotante, por defecto: 0.3: Un factor de escala para aplicar al color rgbFace si no se especifica shadow_rgbFace.
**kwargs: Las palabras clave adicionales se almacenan y pasan a AbstractPathEffect._update_gc().

draw_path ( procesador , gc , tpath , afín , rgbFace ) [fuente] #: Anula el draw_path estándar para agregar el desplazamiento de la sombra y los cambios de color necesarios para la sombra.

clase matplotlib.patheffects. Trazo ( desplazamiento = (0, 0) , ** kwargs ) [fuente] #

Bases:AbstractPathEffect

Un PathEffect basado en líneas que vuelve a dibujar un trazo.

La ruta se trazará con su gc actualizado con los argumentos de palabra clave dados, es decir, los argumentos de palabra clave deben ser valores de parámetro gc válidos.

draw_path ( procesador , gc , tpath , afín , rgbFace ) [fuente] #: Dibuja el camino con gc actualizado.

clase matplotlib.patheffects. TickedStroke ( offset = (0, 0) , espaciado = 10,0 , ángulo = 45,0 , longitud = 1,4142135623730951 , ** kwargs ) [fuente] #

Bases:AbstractPathEffect

Un PathEffect basado en líneas que dibuja una ruta con un estilo marcado.

Este estilo de línea se usa con frecuencia para representar restricciones en la optimización. Las marcas pueden usarse para indicar que un lado de la línea no es válido o para representar un límite cerrado de un dominio (es decir, una pared o el borde de una tubería).

Se puede controlar el espaciado, la longitud y el ángulo de las marcas.

Este estilo de línea a veces se denomina línea rayada.

Consulte también el ejemplo de demostración de contorno .

Ver también los contornos en el ejemplo de optimización .

Parámetros :

desplazamiento (flotante, flotante), predeterminado: (0, 0): El desplazamiento (x, y) que se aplicará a la ruta, en puntos.
flotante de espaciado , predeterminado: 10.0: El espacio entre ticks en puntos.
ángulo de flotación, predeterminado: 45,0: El ángulo entre la ruta y la marca en grados. El ángulo se mide como si fueras una hormiga caminando por la curva, con cero grados apuntando directamente hacia adelante, 90 a tu izquierda, -90 a tu derecha y 180 detrás de ti.
flotación de longitud , por defecto: 1.414: La longitud de la marca en relación con el espaciado. Longitud recomendada = 1,414 (sqrt(2)) cuando ángulo=45, longitud=1,0 cuando ángulo=90 y longitud=2,0 cuando ángulo=60.
**kwargs: Las palabras clave adicionales se almacenan y pasan a AbstractPathEffect._update_gc().

Ejemplos

Consulte el efecto de ruta TickedStroke .

draw_path ( procesador , gc , tpath , afín , rgbFace ) [fuente] #: Dibuja el camino con gc actualizado.

clase matplotlib.patheffects. withSimplePatchShadow ( offset = (2, -2) , shadow_rgbFace = Ninguno , alfa = Ninguno , rho = 0.3 , ** kwargs ) [fuente] #

Bases:SimplePatchShadow

Un atajo PathEffect para aplicar SimplePatchShadowy luego dibujar el artista original.

Con esta clase puedes usar

artist.set_path_effects([path_effects.withSimplePatchShadow()])

como atajo para

artist.set_path_effects([path_effects.SimplePatchShadow(),
                         path_effects.Normal()])

Parámetros :

desplazamiento (flotante, flotante), por defecto: (2, -2): El desplazamiento (x, y) de la sombra en puntos.
shadow_rgbColor de la cara: El color de la sombra.
flotante alfa , predeterminado: 0.3: La transparencia alfa del parche de sombra creado.
rho flotante, por defecto: 0.3: Un factor de escala para aplicar al color rgbFace si no se especifica shadow_rgbFace.
**kwargs: Las palabras clave adicionales se almacenan y pasan a AbstractPathEffect._update_gc().

draw_path ( procesador , gc , tpath , afín , rgbFace ) [fuente] #: Anula el draw_path estándar para agregar el desplazamiento de la sombra y los cambios de color necesarios para la sombra.

clase matplotlib.patheffects. withStroke ( desplazamiento = (0, 0) , ** kwargs ) [fuente] #

Bases:Stroke

Un atajo PathEffect para aplicar Strokey luego dibujar el artista original.

Con esta clase puedes usar

artist.set_path_effects([path_effects.withStroke()])

como atajo para

artist.set_path_effects([path_effects.Stroke(),
                         path_effects.Normal()])

La ruta se trazará con su gc actualizado con los argumentos de palabra clave dados, es decir, los argumentos de palabra clave deben ser valores de parámetro gc válidos.

draw_path ( procesador , gc , tpath , afín , rgbFace ) [fuente] #: Dibuja el camino con gc actualizado.

clase matplotlib.patheffects. withTickedStroke ( offset = (0, 0) , espaciado = 10,0 , ángulo = 45,0 , longitud = 1,4142135623730951 , ** kwargs ) [fuente] #

Bases:TickedStroke

Un atajo PathEffect para aplicar TickedStrokey luego dibujar el artista original.

Con esta clase puedes usar

artist.set_path_effects([path_effects.withTickedStroke()])

como atajo para

artist.set_path_effects([path_effects.TickedStroke(),
                         path_effects.Normal()])

Parámetros :

desplazamiento (flotante, flotante), predeterminado: (0, 0): El desplazamiento (x, y) que se aplicará a la ruta, en puntos.
flotante de espaciado , predeterminado: 10.0: El espacio entre ticks en puntos.
ángulo de flotación, predeterminado: 45,0: El ángulo entre la ruta y la marca en grados. El ángulo se mide como si fueras una hormiga caminando por la curva, con cero grados apuntando directamente hacia adelante, 90 a tu izquierda, -90 a tu derecha y 180 detrás de ti.
flotación de longitud , por defecto: 1.414: La longitud de la marca en relación con el espaciado. Longitud recomendada = 1,414 (sqrt(2)) cuando ángulo=45, longitud=1,0 cuando ángulo=90 y longitud=2,0 cuando ángulo=60.
**kwargs: Las palabras clave adicionales se almacenan y pasan a AbstractPathEffect._update_gc().

Ejemplos

Consulte el efecto de ruta TickedStroke .

draw_path ( procesador , gc , tpath , afín , rgbFace ) [fuente] #: Dibuja el camino con gc actualizado.

matplotlib.patheffects#

`matplotlib.patheffects`#