Esboço de superfície 3d
surf() // sample surf(Z) surf(X, Y, Z) surf(X, Y, fun) surf(X, Y, list(fun, params)) surf(.., colors) surf(.., <GlobalProperty>) surf(.., colors, <GlobalProperty>) surf(axes_handle,...)
two vectors of real numbers, of lengths nx
and
ny
; or two real matrices of sizes ny
x nx
:
They define the data grid (horizontal coordinates of the grid nodes).
All grid cells are quadrangular but not necessarily rectangular.
By default, X = 1:size(Z,2)
and
Y = 1:size(Z,1)
are used.
uma matriz real definindo as alturas da superfície. Não pode
ser omitida. O dado Z é uma matriz ny
x
nx
.
handle of a function, as in surf(x,y, myFun)
where the
expected syntax of myFun
is Z=myFun(X,Y)
.
If the 2D function fun
to plot needs some parameters
as input arguments, the function and its parameters can be specified
through a list, as in surf(x,y, list(delip, -0.4))
or
surf(x,y, list(myfun, a,b))
with
Z = myFun(X,Y, a,b)
If X
or/and Y
are grid-generating
vectors while fun(…)
expects only input matrices,
surf(…)
automatically generates matrices from
X
or/and Y
and properly calls
fun(…)
.
um matriz de reais opcional definindo valores de cores para
cada ponto (X(j),Y(i))
do grid (ver descrição
abaixo).
esta propriedade rerpresenta uma seqüência de pares de
sentenças {PropertyName,PropertyValue}
que
definem propriedades globais de objetos aplicadas a todas as curvas
criadas neste esboço. Para uma completa visualização das
propriedades disponíveis veja GlobalProperty.
este argumento opcional força os eixos a aparecerem dentro dos
eixos selecionados dados por axes_handle
ao invés
dos eixos correntes (ver gca).
surf
desenha uma superfície parametrizada
colorida utilizando um grid retangular definido pelas coordenadas
X
e Y
surf
foi criada para lidar melhor
com a sintaxe do Matlab. Para melhorar a compatibilidade gráfica, usuários
do Matlab devem utilizar surf
(ao invés de plot3d).
Especificação de entrada de dados:
Neste parágrafo, e para sermos mais claros, não mencionaremos os
argumentos opcionais de GlobalProperty
ojá que eles não
interferem na entrada de dados (exceto pelas propriedades
"Xdata"
, "Ydata"
e
"Zdata"
, ver GlobalProperty). É assumido que todos
estes argumentos opcionais podem estar presentes também.
X
or Y
can be :
a) um vetor: se X
for um vetor,
length(X
)=nx
. Respectivamente, se
Y
for um vetor,
length(Y
)=ny
.
b) uma matriz: neste caso, size(X
) (ou
size(Y
)) deve ser igual a
size(Z
).
Especificação de entrada de cores:
Como citado acima, a superfície é criada sobre um gride retangular
de apoio. Consideremos duas variáveis independentes i
e
j
tais que:
a) 1 <= i <= ny and 1 <= j <= nx b) i-1,j-1 ---- i-1,j ---- i-1,j+1 ---… | | | | | i direction i,j-1 ----- i,j ----- i,j+1 ---… | | | | | : : : ............> j direction
Este grid retangular imaginário é utilizado para se contruir o
suporte da superfície real sobre o plano XY
. De fato,
os dados X
,Y
e Z
possuem o mesmo tamanho (mesmo se X
ou
Y
for um vetor, ver abaixo) e podem ser considerados
como três funções x(i,j)
, y(i,j)
e
z(i,j)
especificando a superficie desejada. Se
X
ou Y
forem vetores, eles são
internamente tratados para produzir boas matrizes de dimensões
correspondentes às dimensões da matriz Z
(e o grid é
forçosamente uma região retangular).
Considerando as três funções x(i,j)
,
y(i,j)
e z(i,j)
, a porção da
superfície definida entre dois i
e j
consecutivos é chamada remendo.
Por padrão, quando nenhuma matriz de cores é adicionada a uma
chamada a surf, o parâmetro de cor é ligado o dado Z
.
Quando uma matriz de cores colors
é dada, pode ser
aplicada aos remendos de duas formas diferentes: nos vértices, ou no
centro de cada remendo.
É por isto que, se Z
é uma matriz
[ny
xnx
] , a dimensão da matriz
colors C
pode ser
[ny
xnx
] (uma cor definida por vértice)
ou [ny-1
xnx-1
] (uma cor definida por
remendo).
A representação de cores também varia quando se especifica algumas GlobalProperties (propriedades globais):
A propriedade FaceColor
ajusta o padrão de
gradação: pode ser 'interp'
ou
'flat'
(modo padrão). Quando
'interp'
é selecionado, é realizado uma interpolação
bilinear de cores no remendo. Se size(C
) é igual a
size(Z
)-1 (i.e. for fornecida apenas uma cor ao
remendo) então a cor dos vértices definindo o remendo é ajustada para a
dada cor do remendo.
Quando 'flat'
(modo padrão) é habilitado, é
utilizada uma representação de cores de facetadas (uma cor por remendo).
Se size(C
) é igual a size(Z
) (i.e.
foi fornecida apenas uma cor por os vértices), as últimas linha e coluna
de C
são ignoradas.
Os argumentos GlobalProperty
devem ser usados
para customizar a superfície. Aqui está uma breve descrição de como
funcionam:
esta opção pode ser utilizada para especificar como todas as
superfícies serão desenhadas. Deve sempre ser um par de sentenças
constituidos de um string definindo PropertyName
,
(nome da propriedade) e seu valor associado
PropertyValue
(que pode ser um inteiro ou outra
coisa... dependendo do tipo de PropertyName
).
Note que você pode ajustar múltiplas propriedades : a cor da face e
da borda, dados de cores, mapeamento de dados de cores, cor do
marcador (plano de fundo e primeiro plano), visibilidade, recorte,
espessura das bordas da superfície... (ver GlobalProperty )
Note que todas essas propriedades podem ser (re-)ajustadas através das propriedades da entidade superfície (ver surface_properties).
![]() | Por padrão, esboços sucessivos de superfície são superpostos. Para
limpar o esboço anteirior, use clf() . Para habilitar o
modo auto_clear (limpeza automática) como modo padrão,
edite seus eixos padrões fazendo: gda().auto_clear = 'on'
Entre com o comando surf() para visualizar uma demonstração. |
With a function:
function z=mySurf(x, y, a, b) if ~isdef("a","l"), a = 1, end if ~isdef("b","l"), b = 1, end z = a*x.*sin(y) + b*y.*cos(x); endfunction clf subplot(121), surf(-5:0.2:5, -3:0.2:3, mySurf) // without parameters subplot(122), surf(-5:0.2:5, -3:0.2:3, list(mySurf, 2,-1)) // with parameters gcf().color_map = jetcolormap(100); set(gcf(), "axes_size", [800 350], "rotation_style","multiple"); gca().rotation_angles = [40 -60]; | ![]() | ![]() |
surf(Z):
// inicialização de Z Z =[0.0001 0.0013 0.0053 -0.0299 -0.1809 -0.2465 -0.1100 -0.0168 -0.0008 -0.0000 0.0005 0.0089 0.0259 -0.3673 -1.8670 -2.4736 -1.0866 -0.1602 -0.0067 0.0000 0.0004 0.0214 0.1739 -0.3147 -4.0919 -6.4101 -2.7589 -0.2779 0.0131 0.0020 -0.0088 -0.0871 0.0364 1.8559 1.4995 -2.2171 -0.2729 0.8368 0.2016 0.0130 -0.0308 -0.4313 -1.7334 -0.1148 3.0731 0.4444 2.6145 2.4410 0.4877 0.0301 -0.0336 -0.4990 -2.3552 -2.1722 0.8856 -0.0531 2.6416 2.4064 0.4771 0.0294 -0.0137 -0.1967 -0.8083 0.2289 3.3983 3.1955 2.4338 1.2129 0.2108 0.0125 -0.0014 -0.0017 0.3189 2.7414 7.1622 7.1361 3.1242 0.6633 0.0674 0.0030]; clf // superfície simples subplot(121) surf(Z); // note que X e Y são determinados pelas dimensões de Z // a mesma superfície com faces vermelhas e bordas azuis subplot(122) surf(Z,'facecol','red','edgecol','blu'); gcf().axes_size = [850 400]; | ![]() | ![]() |
surf(X, Y, Z):
// inicialização de X e Y // NB: aqui, X tem as mesmas linhas e Y tem as mesmas colunas X=[-3.0000 -2.3333 -1.6667 -1.0000 -0.3333 0.3333 1.0000 1.6667 2.3333 3.0000 -3.0000 -2.3333 -1.6667 -1.0000 -0.3333 0.3333 1.0000 1.6667 2.3333 3.0000 -3.0000 -2.3333 -1.6667 -1.0000 -0.3333 0.3333 1.0000 1.6667 2.3333 3.0000 -3.0000 -2.3333 -1.6667 -1.0000 -0.3333 0.3333 1.0000 1.6667 2.3333 3.0000 -3.0000 -2.3333 -1.6667 -1.0000 -0.3333 0.3333 1.0000 1.6667 2.3333 3.0000 -3.0000 -2.3333 -1.6667 -1.0000 -0.3333 0.3333 1.0000 1.6667 2.3333 3.0000 -3.0000 -2.3333 -1.6667 -1.0000 -0.3333 0.3333 1.0000 1.6667 2.3333 3.0000 -3.0000 -2.3333 -1.6667 -1.0000 -0.3333 0.3333 1.0000 1.6667 2.3333 3.0000 -3.0000 -2.3333 -1.6667 -1.0000 -0.3333 0.3333 1.0000 1.6667 2.3333 3.0000 -3.0000 -2.3333 -1.6667 -1.0000 -0.3333 0.3333 1.0000 1.6667 2.3333 3.0000]; Y=[-3.0000 -3.0000 -3.0000 -3.0000 -3.0000 -3.0000 -3.0000 -3.0000 -3.0000 -3.0000 -2.3333 -2.3333 -2.3333 -2.3333 -2.3333 -2.3333 -2.3333 -2.3333 -2.3333 -2.3333 -1.6667 -1.6667 -1.6667 -1.6667 -1.6667 -1.6667 -1.6667 -1.6667 -1.6667 -1.6667 -1.0000 -1.0000 -1.0000 -1.0000 -1.0000 -1.0000 -1.0000 -1.0000 -1.0000 -1.0000 -0.3333 -0.3333 -0.3333 -0.3333 -0.3333 -0.3333 -0.3333 -0.3333 -0.3333 -0.3333 0.3333 0.3333 0.3333 0.3333 0.3333 0.3333 0.3333 0.3333 0.3333 0.3333 1.0000 1.0000 1.0000 1.0000 1.0000 1.0000 1.0000 1.0000 1.0000 1.0000 1.6667 1.6667 1.6667 1.6667 1.6667 1.6667 1.6667 1.6667 1.6667 1.6667 2.3333 2.3333 2.3333 2.3333 2.3333 2.3333 2.3333 2.3333 2.3333 2.3333 3.0000 3.0000 3.0000 3.0000 3.0000 3.0000 3.0000 3.0000 3.0000 3.0000]; Z= [0.0001 0.0013 0.0053 -0.0299 -0.1809 -0.2465 -0.1100 -0.0168 -0.0008 -0.0000 0.0005 0.0089 0.0259 -0.3673 -1.8670 -2.4736 -1.0866 -0.1602 -0.0067 0.0000 0.0004 0.0214 0.1739 -0.3147 -4.0919 -6.4101 -2.7589 -0.2779 0.0131 0.0020 -0.0088 -0.0871 0.0364 1.8559 1.4995 -2.2171 -0.2729 0.8368 0.2016 0.0130 -0.0308 -0.4313 -1.7334 -0.1148 3.0731 0.4444 2.6145 2.4410 0.4877 0.0301 -0.0336 -0.4990 -2.3552 -2.1722 0.8856 -0.0531 2.6416 2.4064 0.4771 0.0294 -0.0137 -0.1967 -0.8083 0.2289 3.3983 3.1955 2.4338 1.2129 0.2108 0.0125 -0.0014 -0.0017 0.3189 2.7414 7.1622 7.1361 3.1242 0.6633 0.0674 0.0030 0.0002 0.0104 0.1733 1.0852 2.6741 2.6725 1.1119 0.1973 0.0152 0.0005 0.0000 0.0012 0.0183 0.1099 0.2684 0.2683 0.1107 0.0190 0.0014 0.0000]; scf(3) surf(X,Y,Z) | ![]() | ![]() |
surf(X,Y,Z) on a cylindrical grid.. Facets are still quadrangular:
theta = 0:15:360; r = 25:5:100; [R,T] = ndgrid(r,theta); X = R.*cosd(T); Y = R.* sind(T); Z = sinc(R/8); clf surf(X, Y, Z) gcf().color_map = coolcolormap(50); gca().rotation_angles=[195 -155]; | ![]() | ![]() |
// exemplo 3 // X e Y são vetores => mesmo comportamento que a amostra 1 // com vetores, o grid é inevitavelmente retangular scf(5)// nova figura de número 5 X = [-3.0000 -2.3333 -1.6667 -1.0000 -0.3333 0.3333 1.0000 1.6667 2.3333 3.0000]; Y = X; surf(X,Y,Z) //exemplos com LineSpec e GlobalProperty: xdel(winsid()) // destruindo todas as figuras existentes surf(Z,Z+5) // array de cores especificado e=gce(); e.cdata_mapping='direct' // o padrão é 'scaled' relativo ao mapa de cores colormap e.color_flag=3; // modo de gradação interpolada. O padrão é 4 (modo 'flat') para surf scf(2) surf(X,Y,Z,'colorda',ones(10,10),'edgeco','cya','marker','penta','markersiz',20,'markeredg','yel','ydata',56:65) scf(3) surf(Z,'cdatamapping','direct') scf(4) surf(Z,'facecol','interp') // interpolated shading mode (color_flag == 3) scf(10) axfig10=gca(); scf(11); surf(axfig10,Z,'ydat',[100:109],'marker','d','markerfac','green','markeredg','yel') // draw onto the axe of figure 10 | ![]() | ![]() |
Version | Description |
6.0.2 | The "Foreground", "markForeground", and "markBackground" global properties colors can now be specified as named colors chosen in the full predefined colors list, or by their "#RRGGBB" hexadecimal codes, or by their colormap indices. surf(X,Y,fun..) and surf(X,Y,list(fun, params)) syntaxes added. |