surf

surf(Z,<GlobalProperty>)
surf(Z,color,<GlobalProperty>)
surf(X,Y,Z,<color>,<GlobalProperty>)
surf(<axes_handle>,...)

Parâmetros

Z

uma matriz real definindo as alturas da superfície. Não pode ser omitida. O dado Z é uma matrizm xn.

X,Y

dois vetores ou matrizes reais: sempre ajustados juntos, estes dados definem um novo grid padrão. Estes novos componentes X e Y do grid devem coincidir com as dimensões de Z (ver a descrição abaixo).

color

um matriz de reais opcional definindo valores de cores para cada ponto (X(j),Y(i)) do grid (ver descrição abaixo).

<GlobalProperty>

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.

<axes_handle>

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

Descrição

surf desenha uma superfície parametrizada colorida utilizando um grid retangular definido pelas coordenadas X e Y (se {X,Y} não forem especificados, este grid é determinado utilizando-se as dimensões da matriz Z) ; em cada ponto deste grid, uma coordenada Z é dada utilizando-se uma matriz Z (apenas dados obrigatórios). 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.

Se Z é a única matriz especificada, surf(Z) esboça a matriz Z versus o grid definido por 1:size(Z,2) ao longo do eixo x e 1:size(Z,1) ao longo do eixo.

Se uma tripla {X,Y,Z} for fornecida, Z deve ser uma matriz de size(Z)= [mxn], X or Y can be :

• a) um vetor: se X for um vetor, length(X)=n. Respectivamente, se Y for um vetor, length(Y)=m.

  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:

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 color é 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 [mxn] , a dimensão da matriz color C pode ser [mxn] (uma cor definida por vértice) ou [m-1xn-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:

GlobalProperty

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

Observações

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:

da=gda();

da.auto_clear = 'on'

Entre com o comando surf para visualizar uma demonstração.

Exemplos

Ver Também

• plot2d — esboço 2d
• clf — Limpa ou reajusta a (janela da) figura gráfica corrente para valores padrões
• xdel — deleta uma janela de gráficos
• delete — Deleta uma entidade gráfica e seus galhos
• LineSpec — Customização rápida de linhas que aparecem em um esboço
• GlobalProperty — Customização de aparência dos objetos (curvas, superfícies...) num comando plot ou surf.