condshiftneurons
Implementation of Conditionally Shifted Neurons (CSN) for metalearning from:
The author's implementation of CSN seems to be unreleased as of yet and in any case, the author mentioned the code is in Chainer. So here's an implementation in Tensorflow!
There are some implementation differences, eg. learning rate, number of convolutional layers etc. Refer to Implementation Details and Differences below for details.
WIP  only Sinusoid and Omniglot and using Direct Feedback (see Section 2.3 of paper) for now, miniImageNet WIP.
Thanks to @cbfinn for the data generation scripts!
Instructions
Sinusoid
This experiment was not in the paper but was used by Finn et al. (2017) to demonstrate metalearning regression. Decided to try it out with CSN.
Run the following to train CSN on the sinusoid toy experiment, as described in Section 5.1 of Finn et al. (2017).
$ python main.py train datasource=sinusoid
Default task parameters:
 Number of training samples per task
num_shot_train=10
 Number of test samples per class per task
num_shot_test=10
Default training parameters:
 Number of metatraining iterations
metatrain_iterations=20000
 Batchsize per metatraining iteration
meta_batch_size=32
 Metalearning rate
meta_lr=0.0003
Run this to test the trained model and plot the result:
$ python main.py test datasource=sinusoid
Sample graph that shows output of regression network before and after shift.
In the above sample, the after shift plot is generated by testing with x = np.arange(5., 5., 0.2)
samples and plotting these 50 points against the predicted output from the trained model. This means a different shift is used for each point and the combination of all the shifts give the resulting curve. Refer to the Summary below for a detailed explanation. Implementation details are documented below.
There is also a pretrained model you can use for testing:
$ python main.py test datasource=sinusoid savepath=pretrained_sinusoid
Omniglot
First, follow the instructions here to download, sort and resize the Omniglot dataset.
Shout out and thanks to @cbfinn for the script!
Then just run this to train CSN on the Omniglot 5way 1shot task:
$ python main.py train datasource=omniglot
Default task parameters:
 Number of classes per task
num_classes=5
 Number of training samples per class per task
num_shot_train=1
 Number of test samples per class per task
num_shot_test=1
Default training parameters:
 Number of metatraining iterations
metatrain_iterations=40000
 Batchsize per metatraining iteration
meta_batch_size=32
 Metalearning rate
meta_lr=0.0003
Run the following to view the Tensorboard log:
$ tensorboard logdir=logs/
Finally, run this to test the trained model:
$ python main.py test datasource=omniglot
There is the option to test with a different number of classes, by specifying num_test_classes
. A model trained on Nway tasks can only be tested on Mway tasks, where M <= N.
With the smaller architecture here, I can get a ~0.96 accuracy on the test set. This is significantly lower than reported in the paper but there are many implementation differences (see below).
Help
See main.py for the full list of flags or just run:
$ python main.py help
Summary
In this paper, Munkhdalai et al. built on their previous work (Munkhdalai et al., 2017) and introduced an improved adaptiveattesttime network architecture for metalearning.
In regular neural network training, we calculate the gradients of the loss function with respect to the network parameters. These gradients are used to update the network parameters, which hopefully reduces test loss.
By aggregating parameter updates across many training iterations and samples, we ideally end up with a network that works well on any sample from the same distribution.
What if we only have an extremely small dataset? For instance, in a 5way 1shot task, we only have 5 training samples, 1 per class. We could train the network by simply aggregating network updates across the 5 samples. An interesting alternative explored here is to decide which training samples are the most relevant during test time and only update the network using the most relevant training samples. In other words, the model shifts and adapts to each test sample during test time.
Or to cite the paper:
Additionally, [conditionally shifted neurons] have the capacity to shift their activation values on the fly based on auxiliary conditioning information. These conditional shifts adapt model behavior to the task at hand.
Briefly and on a highlevel, here's what happens during metatest:
Assume a 3way 1shot classification task with a main classifier network, where each sample is a 2dimensional vector. The initialization of the main classifier network has been metatrained but has not seen the new metatest task.
Main classifier network that takes in a 2dimensional input and produces a 3dimensional logit for classification.

Each training sample is used to generate a KeyValue pair, where the Key is an embedding of the sample and the Value is the set of corresponding network updates ie. using Value of sample A (Value A) to update the classifier is similar to training the classifier on sample A
Each 2dimensional sample generates a Key (5dimensional in this case) and Value (neuronspecific network updates). 
Each test sample is also used to generate a Key, which is then compared against the Training Keys, with an attention/alignment mechanism
Each test sample also generates a Key, which is compared against the Training Keys. 
Calculate a set of network updates using the alignment of the Test Key with the Training Keys eg. if the postsoftmax alignment is (0.5, 0.4, 0.1) then take 50% of Value A + 40% of Value B + 10% of Value C
The update for the test sample is a weighted sum of the training samples' Values. 
Shift the main classifier network using the calculated set of network updates (termed as Conditionally Shifted Neurons)
Use the calculated network updates to shift the network  basically adding the updates to the neurons (see Equation 1 in paper). 
Classify the test sample with the shifted network
Put simply, if the test sample is most aligned to training sample A, we use gradient information derived from training sample A to shift the network and classify the test sample.
During metatraining, we train three main things:
 The initialization of the main network
 The Key Function which is parameterized as a neural network
 The Value Function which is parameterized as a neural network
But if the test sample is most aligned to training sample A, why don't we just classify it to be the same class as training sample A?
We can do that, but consider the case where the test sample is equally aligned to all three samples. Then the algorithm automatically incorporates gradient information from all three samples to make the classification. If we just use the alignment to make the decision, we would be stuck.
Does this work with regression?
As can be seen from the sinusoid example below (and in Instructions above), the algorithm does work reasonably well on fewshot regression.
One interesting thing to note is that the resulting output is somewhat discontinuous, since the output is actually made up of different shifts at every point.
We can demonstrate this by explicitly plotting the separate shifts.
First, with a test sample of x = 3
we calculate the resulting shifted network and then use this shifted network to classify all 50 points in x = np.arange(5., 5., 0.2)
. For illustration we also do the same with x = 0
and x = 3
.
(Note that during actual testing, we do not use a single shift to classify every test sample. Each test sample has its own shift calculated as a weighed sum of the Training Values (see above).)
Applying shift from x = 3
to all test samples.
Applying shift from x = 0
to all test samples.
Applying shift from x = 3
to all test samples.
Notice that all three results are very different and fit far more poorly to the ground truth as compared to the very first output shown above made up of different shifts. It becomes clearer when we plot everything together.
The shifted output for x = 3
intersects with the final result (in red) at x = 3
(leftmost vertical line), since the prediction for x = 3
is generated using that shift.
Likewise for x = 0
and x = 3
, as well as every test sample that was used to generate the final result. This also means that rather than being a single function, the final result in red is a combination of different shifts applied to the regression network. Hence the somewhat discontinuous descriptor used earlier. With this realization, it is also pretty cool that the combination of all these shifts actually generate a decentlooking output.
Interesting Notes and Relations
These are my observations and not mentioned by the authors ie. any mistakes are entirely on my part.
1step Gradient Descent
In the case that gradient information from 1 training sample is used, the shifted network is akin to the initial network plus one step of gradient descent on the single training sample.
Likewise, if gradient information from all training samples are used, the shifted network is akin to the initial network plus one step of gradient descent on the entire training set as a single minibatch.
CSN can hence be seen as a general form of these two cases.
Relation to Learned Initializations
During metatraining, the main network is also trained such that the initial network plus a onestep "shift" during test time should be sufficient to classify the test sample correctly.
Hence, the metatraining of CSN also optimizes the parameters/"initialization" of the initial network, similar to MAML by Finn et al. (2017) and Reptile by Nichol et al. (2018).
Considered as a more general form of MAML, CSN parameterizes the network update function, whereas MAML/Reptile uses a regular gradient descent algorithm. (But using a parameterized update for MAML/Reptile is definitely possible.)
Relation to Learned Optimizers
Andrychowicz et al. (2016) and Ravi & Larochelle (2017) introduced parameterized optimizers, which allowed us to optimized optimizers (hohoho!).
Similarly, the Value Function here is a sort of parameterized optimizer that takes in gradient information and outputs network updates ie. the "shifts". The algorithm also incorporates training and test information to output the final set of CSNs for classification. This is akin to a dynamic optimizer that uses gradient information and sample context to output an optimized update.
Relation to Metricbased Metalearners
As mentioned earlier, it could be possible to use the calculated alignment between test and training samples to directly output the classification.
This would then be similar to Matching Networks by Vinyals et al. (2016) and Prototypical Networks by Snell et al. (2017), as well as the use of Siamese networks in Koch's thesis (2015).
However, instead of classifying based on a similarity metric, the similarity/alignment here is used to provide information for updating a classification network. This might be arguably more robust than metric/similaritybased metalearners, although less efficient.
Implementation Details and Differences
adaFFN for Sinusoid Toy Task
The paper did not demonstrate CSN on the sinusoid toy task but I thought it would be fun to try it out on a regression task. Here are the implementation details.
Main Network
 2 hidden layers with 32 units and ReLU activation
 Output layer with 1 unit and no activation
This follows the architecture used for the same task by Finn et al. (2017).
Key Function
 2 hidden layers with 10 units and ReLU activation
 Output layer with 4 units and no activation
Value Function
 2 hidden layers with 10 units and ReLU activation
 Output layer with 1 unit and no activation
Others
 For the Conditionally Shifted Neurons, I perform the shift/addition before the ReLU activation function instead of after (see Equation 1 in paper)
 The softattention mechanism is the same as described in the paper
 The Direct Feedback conditioning is the same as described in the paper
 The loss function is the mean squared error
 The task test loss uses the amplitude to scale the labels and predictions before calculating mean squared error to correct for the difference in loss magnitude due to the amplitude
 The task training loss does not do amplitude correction since this would mean that amplitude information is required to obtain the shifts
adaCNN for Omniglot 5way 1shot
In general, a smaller architecture is used here as compared to in the paper, so that I could train the model in a shorter time. No dropout is implemented here, in contrast to the paper. The Adam optimizer also has a smaller learning rate of 3e4, rather than 1e3 reported in the paper (Appendix A). No gradient clipping is used.
Main Network
 I use 4 convolutional blocks where each block comprises of:
 CNN layer with 3x3 kernel, with padding, with 32 filters and ReLU activation
 Max pool layer with pool size of 2x2 and stride of 1x1
 The output is flattened and fed to a dense layer to give the logits
The paper is somewhat confusing here, where Section 4.1 mentions using 64 filters and 5 layers while Appendix A Table 4 reports 32 filters and 5 layers.
Key Function
 Similar to the Main Network but with 2 convolutional blocks instead
 The output is flattened and fed to a dense layer with 32 units
The paper mentions using another network with the same architecture as the main network for the key function.
Value Function
 The input is a flattened form of the Direct Feedback gradients
 I use a network with three dense layers:
 32 hidden units and ReLU activation
 32 hidden units and ReLU activation
 1 hidden unit and no activation
The paper mentioned using a 3layer MLP with ReLU activation with 20 or 40 units per layer.
Others
 For the Conditionally Shifted Neurons, I perform the shift/addition before the ReLU activation function instead of after (see Equation 1 in paper)
 The softattention mechanism is the same as described in the paper
 The Direct Feedback conditioning is the same as described in the paper