# the framework to use for deep learning if you groupthink like Google

A C++/Python neural network toolkit by Google. I am using it for solving general machine-learning problems, and frequently enough that I have notes. The notes are obso

See, of course, nostalgebraist’s rant about how I am not just imagining it, this is an ill-documented mess.

## Abstractions

• Keras supports tensorflow and Theano as a backend, for comfort and convenience. See below for some notes.

• Tensorf2Tensor

Tensor2Tensor, or T2T for short, is a library of deep learning models and datasets designed to make deep learning more accessible and accelerate ML research. T2T is actively used and maintained by researchers and engineers within the Google Brain team and a community of users.

• tensorflowslim eases some boring bits.

• sonnet is Deepmind’s tensorflow library and shares with keras layer-like abstractions and some helpers to make recurrent neural nets bearable.

There are some other frontends, which seem a bit less useful to my mind:

• tflearn wraps the tensorflow machine in scikit-learn (Although the implementation is not very enlightening, nor the syntax especially clear.)

• estimator is a tensorflow generic estimator class. Relationship to other wrappers is not clear to me, but finding out would be tedious, so I will never know.

My objection to these latter abstractions is that they seem to make the easy bits not easier but different, and the hard bits no easier. tflearn might be useful if you need to plug into an existing scikit-learn workflow.

## Tutorials

See also keras tutorials below.

## Debugging

Google’s own Tensorflow without a phd.

Basic ways:

• Not in mid training? Explicitly fetch, and print (or do whatever you want) using Session.run()

• Tensorboard Histogram and Image Summary (see next section)

• tf.Print(input, data, message=None, first_n=None, summarize=None, name=None) (link)

• tf.Assert(condition, data, summarize=None, name=None) (link)

• Interpose any python codelet in the computation graph

• A step-by-step debugger

• tfdbg_: The TensorFlow debugger

### Tensorboard

Tensorboard is a de facto debugging tool standard. It’s not immediately intuitive; I recommend reading Li Yin’s explanation.

Minimally,

tensorboard --logdir=path/to/log-directory

or, more usually,

tensorboard --logdir=name1:/path/to/logs/1,name2:/path/to/logs/2 --host=localhost

or, lazily, (bash)

tensorboard --logdir=$(ls -dm *.logs |tr -d ' \n\r') --host=localhost (fish) tensorboard --logdir=(string join , (for f in *.logs; echo (basename$f .logs):\$f; end)) --host=localhost

In fact, that sometimes works not so well for me. Tensorboard reeeeally wants you to explicitly specify your folder names.

#!/bin/env python3

from pathlib import Path
from subprocess import run
import sys

p = Path('./')

logdirstring = '--logdir=' + ','.join([
str(d)[:-5] + ":" + str(d)
for d in p.glob('*.logs')
])

proc = run(
[
'tensorboard',
logdirstring,
'--host=localhost'
]
)
• Projector visualises embeddings:

TensorBoard has a built-in visualizer, called the Embedding Projector, for interactive visualization and analysis of high-dimensional data like embeddings. It is meant to be useful for developers and researchers alike. It reads from the checkpoint files where you save your tensorflow variables. Although it’s most useful for embeddings, it will load any 2D tensor, potentially including your training weights.

## Getting data in

This is a depressingly complex topic; Likely it’s more lines of code than building your actual learning algorithm.

For example, things break differently if

• you are inputting data of variable dimensions via python which requires a “feed”, which requires keeping references to a placeholder Op around, and ALWAYS resubmitting the data every time you run an op, even if the data is not required for the current Op, or

• Or inputting a Variable (which may also be feeds, just to mess with you, and claim to also be variable dimensions but that never works for me) via C++.

These interact in various different ways that seem irritating, but are probably to do with enabling very large scale data reading workflows, so that you might accidentally solve a problem for Google and they can get your solution for cheap.

Here’s a walk through of some of the details. And here are the manual pages for feeding and queueing

My experience that that stuff is so horribly messy that you should just build different graphs for the estimation and deployment phases of your mode and implement them each according to convenience. This of course is asking for trouble with errors

I’m not yet sure how to easily transmit the estimated parameters between graphs in these two separate phases… I’ll make notes about THAT when i come to it.

## (Non-recurrent) convolutional networks

NB CNN axis ordering is easy to mess up. The Theano guide to convolutions is clearer if you want to work out the actual dimensions your tensors should have. It also gives an intelligible account of how you invert convolutions for decoding.

The Tensorflow convolution guide is more lackadaisical, but it does get us there:

For the SAME padding, the output height and width are computed as:

out_height = ceil(float(in_height) / float(strides[1]))
out_width  = ceil(float(in_width) / float(strides[2]))

For the VALID padding, the output height and width are computed as:

out_height = ceil(float(in_height - filter_height + 1) / float(strides[1]))
out_width  = ceil(float(in_width - filter_width + 1) / float(strides[2]))

TensorFlow supports NHWC (default) and NCHW (cuDNN default). The best practice is to build models that work with both NCHW and NHWC as it is common to train using NCHW on GPU, and then do inference with NHWC on CPU.

NCHW is, to be clear, (batch, channels, height, width).

Theano by contrast, is AFAICT always NCHW.

## Recurrent networks

The documentation for these is abysmal.

To write: How to create standard linear filters in Tensorflow.

For now, my recommendation is to simply use keras, which makes this easier inside tensorflow, or pytorch, which makes it easier overall.

tensorflow fold is a library which ingests structured data and simulates pytorch-style dynamic graphs dependent upon its structure.

### Official documentation

The Tensorflow RNN documentation, as bad as it is, is not even easy to find, being scattered across several non-obvious locations without consistent crosslinks.

To make it actually make sense without unwarranted time wasting and guessing, you will then need to read other stuff.

## Training in the cloud because you don’t have NVIDIA sponsorship

See practical cloud computing, which has a couple of sections on that.

## Extending

Tensorflow allows binary extensions but don’t really explain how it integrates with normal python builds. Here is an example from Uber.

## Misc HOWTOs

### Dynamic graphs

Pytorch has JIT graphs and they are super hip, so now tensorflow has a dynamic graph mode, called Eager.

### GPU selection

setGPU sets NVIDIA_VISIBLE_GPU to the least loaded GPU.

### Silencing tensorflow

TF_CPP_MIN_LOG_LEVEL=1 primusrun python run_job.py args

## Hessians and higher order optimisation

Slightly outdated, Hessian matrix. There is a discussion on Jacobians in TF, including, e.g. fancy examples by jjough:

here’s mine – works for high-dimensional Jacobians (numerator and denominator have >1 dimension), undefined batch sizes, and tensors that are not statically known.

def tf_jacobian(tensor2, tensor1, feed_dict, sess = tf.get_default_session()):
"""
Computes the tensor d(tensor2)/d(tensor1) recursively.
:param tensor2: numerator of Jacobian
:param tensor1: denominator of Jacobian
:param feed_dict: input data (need this if tensors are not statically known)
:return: a tensor of dimension (dim_tensor2 x dim_tensor1)
"""
# can’t do tensor.get_shape() because it doesn’t work for undefined batch size
shape = list(sess.run(tf.shape(tensor2), feed_dict))
if shape:
# split tensor2 along first dimension and recur
# int trick from https://github.com/tensorflow/tensorflow/issues/7754
tensor2_split = tf.split(axis = 0, num_or_size_splits = int(shape[0]), value = tensor2)
grad_split = [tf_jacobian(tf.squeeze(M, squeeze_dims = 0), tensor1, feed_dict) for M in tensor2_split]
else:
else:
# replace any undefined gradients with zeros
return tf.zeros_like(tensor1)

And here’s one for batched tensors:

def batch_tf_jacobian(
tensor2,
tensor1,
feed_dict,
sess = tf.get_default_session()):
"""
Computes the matrix d(tensor2)/d(tensor1) recursively.
Tensorflow doesn’t really have its own Jacobian operator
(tf.gradients sums over all dims of tensor2).

:param tensor2: numerator of Jacobian, first dimension is batch
:param tensor1: denominator of Jacobian, first dimension is batch
:param feed_dict: input data (need this if tensors are not statically known)
:return: batch Jacobian tensor
"""
shape2 = list(sess.run(tf.shape(tensor2), feed_dict))
shape1 = list(sess.run(tf.shape(tensor1), feed_dict))

jacobian = tf_jacobian(tensor2, tensor1, feed_dict)
batch_size = shape2[0]

batch_jacobian = [
tf.slice(
jacobian,
[i] + [0]*(len(shape2)-1) + [i] + [0]*(len(shape1)-1),
[1] + [-1]*(len(shape2)-1) + [1] + [-1]*(len(shape1)-1)
)
for i in range(batch_size)]
batch_jacobian = [
tf.squeeze(tensor, squeeze_dims = (0, len(shape2)))
for tensor in batch_jacobian]
batch_jacobian = tf.stack(batch_jacobian)
return batch_jacobian

### Manage tensorflow environments

Tensorflow+pip+conda

### Optimisation tricks

Simplify distributed training using Horovod.

## Probabilistic networks

Tensorflow probability defines an ecosystem of probabilistic NN united by their terrible documentation (although they have many tutorials online). Blei Lab’s software tool, Edward (source) seems to be included in that tensorflow suite and it has good documentaiton.