3D data objects: the data3d module

astra.data3d.change_geometry(i, geometry)

Change the geometry of a 3D object.

Parameters:

• i (int) – ID of object.
• geometry (dict) – Volume or projection geometry.

astra.data3d.clear()

Clear all 3D data objects.

astra.data3d.create(datatype, geometry, data=None)

Create a 3D object.

Parameters:

• datatype (string) – Data object type, ‘-vol’ or ‘-sino’.
• geometry (dict) – Volume or projection geometry.
• data (float or numpy.ndarray) – Data to fill the constructed object with, either a scalar or array.

Returns:

int – the ID of the constructed object.

astra.data3d.delete(ids)

Delete a 2D object.

Parameters:ids (int or list) – ID or list of ID’s to delete.

astra.data3d.dimensions(i)

Get dimensions of a 3D object.

Parameters:i (int) – ID of object. Returns:tuple – dimensions of object with ID i.

astra.data3d.get(i)

Get a 3D object.

Parameters:i (int) – ID of object to get. Returns:numpy.ndarray – The object data.

astra.data3d.get_geometry(i)

Get the geometry of a 3D object.

Parameters:i (int) – ID of object. Returns:dict – The geometry of object with ID i.

astra.data3d.get_shared(i)

Get a 3D object with memory shared between the ASTRA toolbox and numpy array.

Parameters:i (int) – ID of object to get. Returns:numpy.ndarray – The object data.

astra.data3d.get_single(i)

Get a 3D object in single precision.

Parameters:i (int) – ID of object to get. Returns:numpy.ndarray – The object data.

astra.data3d.info()

Print info on 3D objects in memory.

astra.data3d.link(datatype, geometry, data)

Link a 3D numpy array with the toolbox.

Parameters:

• datatype (string) – Data object type, ‘-vol’ or ‘-sino’.
• geometry (dict) – Volume or projection geometry.
• data (numpy.ndarray) – Numpy array to link

Returns:

int – the ID of the constructed object.

astra.data3d.store(i, data)

Fill existing 3D object with data.

Parameters:

• i (int) – ID of object to fill.
• data (float or numpy.ndarray) – Data to fill the object with, either a scalar or array.