Este comando é utilizado para criar novos arranjos de dados numéricos. Basicamente, qualquer tipo de dado numérico existente em Python pode ser utilizado como elemento de um arranjo, e o arranjo criado é homogêneo, ou seja, todos os elementos do arranjo terão o mesmo tipo numérico. O arranjo pode ser multidimensional.
É importante notar que esta função, embora devolva objetos do tipo ndarray, não é uma classe, e portanto não pode ser herdada. Existem outras maneiras de criar objetos que emulam o comportamento de arranjos. Abaixo descrevemos os argumentos desta função.
qualquer tipo iterável de Python, seja uma lista, uma tupla ou até mesmo outro arranjo. O arranjo criado terá as mesmas dimensões de object.
indica o tipo numérico dos dados armazenados no arranjo. Para especificar, basta passar a este argumento o tipo desejado (ou seja, int, float, complex, etc.). Este argumento não precisa ser especificado — se não for especificado, então o tipo será determinado automaticamente, sendo o tipo mais simples que possa abarcar toda a precisão dos números incluídos em object. Este argumento também permite o uso de descritores, que permitem trabalhar com arranjos como se fossem registros. Veja maiores informações em dtype().
se este argumento for verdadeiro, então o arranjo criado será uma cópia do objeto original. Isso é útil pois as operações feitas nos arranjos criados não influenciarão os valores originais. Se não for especificado, uma cópia sempre será feita.
este argumento permite a fácil conversão de programas escritos em C ou FORTRAN para o NumPy. A ordem se refere à ordem em que os índices são definidos em arranjos multidimensionais. Se 'C' for passado como valor deste argumento, então a ordem de acesso é [linha, coluna] . Se 'FORTRAN' for passado como valor deste argumento, então a ordem de acesso é [coluna, linha].
Nestes exemplos, consideraremos que o módulo numpy foi carregado com a linha de comando from numpy import *. Se você fizer a importação de maneira diferente, não se esqueça de especificar o espaço de nomes sendo utilizado. Estes exemplos podem ser testados diretamente na linha de comando.
Para criarmos um arranjo simples, na forma de uma matriz-linha, usamos o comando abaixo. Note que o tipo dos números criados é inteiro:
Se desejamos criar uma matriz-coluna, utilizando números em ponto flutuante, é só passar object de maneira adequada:
Alternativamente, poderíamos passar o argumento dtype especificando o tipo que desejamos criar. Note que os números no objeto original são inteiros. Para demonstrar a capacidade do Python, vamos criar um arranjo de números complexos, com os quais o Python trabalha nativamente:
Para criar um arranjo de duas (ou mais) dimensões, basta que object seja uma lista, tupla ou qualquer outro objeto iterável com mais dimensões:
Quando criamos um arranjo multidimensional, muitas vezes nosso objeto inicial tem apenas uma dimensão. Para que o arranjo resultante tenha as dimensões desejadas, usamos o argumento ndmin. O arranjo vai continuar tendo o mesmo formato que o objeto original, mas vai ser tratado como um objeto multidimensional:
Esta página é um template para a introdução e criação centralizada de links para um determinado módulo científico para Python, não importando qual seja o módulo, qual seja a sua área, etc. Pedimos que você siga a estrutura desta página para que a documentação presente neste site fique organizada uniformemente.
Inclua, antes de qualquer coisa, uma breve introdução de um ou dois parágrafos a respeito do módulo que você deseja documentar. Não se esqueça de incluir links para o site oficial do módulo e qualquer outra referência relevante. Em sua descrição, uma pequena lista com as características principais do módulo pode ser bastante útil para que o usuário, em uma busca, saiba se o módulo é adequado ou não às suas necessidades:
Abaixo temos uma lista de tutoriais disponíveis para o Módulo, para que iniciantes, ou aqueles que nunca trabalharam com o Módulo antes possam se familiarizar de maneira suave. Se você tem um tutorial disponível para este módulo, ou se deseja publicá-lo neste wiki, inclua-o na lista abaixo:
Siga o link para a Documentação do Módulo, que contém entradas específicas para cada um dos comandos disponíveis desse pacote, com explicações claras e exemplos adequados.