Multiple Images in one Notebook Cell

[hohlraum]

Using Image() to display inline pictures in a notebook seems to only work reliably if Image() is the last command in the cell. For instance:

print 'before'
Image(filename = 'picture.png')

This prints the string, and displays the picture as it should.

print 'before'
Image(filename = 'picture.png')
print 'after'

This prints the two strings, but does not display the picture.

print 'Label for one'
Image(filename = 'one.png')
print 'Label for two'
Image(filename = 'two.png')

This prints the two strings, and then only displays the second image.

for img in ['one.png', 'two.png']:
    Image(filename = img)

This doesn't display anything.

[Carreau]

This is a perfectly reasonable and expected behavior. You seem to misunderstand
the difference between displaying an object and having an object beeing the output of a cell.

Image create an Image object that, if last statement, trigger the display hook that shows it.
As you yourself point out, to print a string you use print. You expect :

's1'
's2'
's3'

In a cell to only show s3 right ?

Same goes for Image/HTML/Javascript/... or any object that have a representation. You need to explicitly 'display' them.

So here you might want to do

from IPython.display import display
my_image = Image(...)
...
display(my_image)

So display is the equivalent of "print" but for rich object.

Or in short

display(Image(...))

You will see that the difference between a "returned" object that trigger display hook and the display() version is that the first get the Out[..]prompt. Not the other.
(and actually you can display the same object many times)

from IPython.display import display
my_image = Image(...)
for i in range(10):
    display(my_image)

[hohlraum]

Thanks for clearing that up. You're right, I was conflating the effect of creating the object with displaying it. Your example with the strings makes clear the difference.

The docstring for Image was part of the problem. It reads:

Create a display an PNG/JPEG image given raw data.

When this object is returned by an expression or passed to the display function, it will result in the image being displayed in the frontend.

Perhaps better as:

Create a PNG/JPEG image object given raw data.

When this object is returned by a cell or passed to the display function, it will result in the image being displayed in the frontend.

[Carreau]

Would't this be a perfect time to do a Pull Request ?