El método add_subplot asociado a una figura añade un conjunto de ejes a la misma pero suponiéndolo en una matriz de columnas y filas (de conjuntos de ejes) y creándolo en la posición indicada de dicha matriz.
Si se invoca el método sin añadir argumentos, se supone que dicha matriz está formada únicamente por un conjunto de ejes (es decir, una columna y una fila):
Pero si se invoca añadiendo como argumentos el número de filas de la matriz, el número de columnas de la matriz y la posición que ocupa el conjunto de ejes a crear, se supone una matriz de dichas dimensiones y se sitúa el conjunto de ejes en la posición correcta:
En el ejemplo anterior partimos de 3 conjuntos de datos (y1, y2 e y3) a mostrar en sendas gráficas y, para cada uno de ellos creamos un conjunto de ejes con el método add_subplot. En los tres casos se indica una matriz de 2 filas y 3 columnas. El primer conjunto de ejes creado -con la gráfica de color azul- se sitúa en la posición 2 (las posiciones se cuentan a partir de 1, de izquierda a derecha y de arriba abajo). El segundo conjunto de ejes -con la gráfica de color rojo- se sitúa en la posición 1, es decir, en la esquina superior izquierda de la matriz. Y el tercer conjunto de ejes -con la gráfica de color verde- se sitúa en la posición 6, es decir, en la esquina inferior derecha. El resto de espacios en la matriz quedan sin ocupar.
Este método también acepta los parámetros sharex y sharey que controlan la compartición de los ejes, y el parámetro label que asigna una etiqueta al conjunto de ejes creado.