本文へ移動

k8o

お問い合わせ

255文字以内で入力してください

GitHub Issueからのお問い合わせもお待ちしております。

Blog

公開: 2025年4月13日(日)更新: 2026年11月9日(月)約9分で読めます

Float16Arrayで16bit浮動小数点数を扱うときの範囲と精度

Float16Arrayは、16bit(半精度)の浮動小数点数を1要素2バイトで持つTypedArrayです。扱える範囲は±65,504で、精度はFloat32Arrayより落ちます。WebGPUや機械学習で使うときの注意点を説明します。

Newly availableFloat16Array2025年〜
  • Chrome135
  • Edge135
  • Firefox129
  • Safari18.2

はじめに

Float16Arrayは、16bit(半精度)の浮動小数点数を1要素2バイトで並べるTypedArrayです。Float32ArrayやFloat64Arrayの16bit版にあたります。Chrome 135が対応して、Baseline 2025に入りました。

JavaScriptの中の計算には、Float32ArrayやFloat64Array、普通の配列を使います。WebGPUのシェーダーや機械学習のモデルは、16bitの浮動小数点数でデータを受け渡すことがあります。これまではFloat32Arrayで倍のメモリを使うか、Uint16Arrayにビットを自分で組み立てて入れるしかありませんでした。Float16Arrayなら、16bitの浮動小数点数をそのまま読み書きできます。

扱える範囲

プロパティやメソッドは、ほかのTypedArrayと同じです。1要素は2バイトで、-65,504から65,504までの数を扱えます。

js
// 要素数3のFloat16Arrayを作る。初期値は0
const float16 = new Float16Array(3);
float16[0] = 1.5;
float16[1] = 100000;
console.log(float16[0]); // 1.5
console.log(float16[1]); // Infinity
console.log(float16[2]); // 0
console.log(float16.length); // 3
console.log(float16.BYTES_PER_ELEMENT); // 2

範囲を超えた100000はInfinityになります。境目では、65519は65504に丸められ、65520はInfinityになります。整数をそのまま表せるのは2048までで、2049を入れると2048になります。

WebGPUとWebGLに渡す

WebGPUでは、Float16ArrayをwriteBuffer()にそのまま渡せます。シェーダーでf16を使うには、デバイスを作るときにshader-f16の機能を要求します。

js
const adapter = await navigator.gpu.requestAdapter();
const device = await adapter.requestDevice({ requiredFeatures: ['shader-f16'] });
const input = new Float16Array([0.5, 1.5, -2, 65504]);
const buffer = device.createBuffer({
  size: input.byteLength,
  usage: GPUBufferUsage.STORAGE | GPUBufferUsage.COPY_DST,
});
device.queue.writeBuffer(buffer, 0, input);

シェーダーの側ではenable f16;を書き、array<f16>で受けます。

wgsl
enable f16;
@group(0) @binding(0) var<storage, read> src: array<f16>;

このbufferをarray<f16>として読むコンピュートシェーダーで、値をf32に写して読み戻すと、[0.5, 1.5, -2, 65504]が返ります。

WebGL 2のテクスチャにHALF_FLOATで渡すときは、Float16Arrayをそのまま渡せません。texImage2D()に渡すとINVALID_OPERATIONになり、Chromeのコンソールにはtype HALF_FLOAT_OES but ArrayBufferView is not NULL and not Uint16Arrayと出ます。同じバッファをUint16Arrayで包み直せば受け付けられ、読み戻すと入れた値のままです。

js
const gl = document.createElement('canvas').getContext('webgl2');
const pixel = new Float16Array([0.5, 1.5, -2, 65504]);
gl.bindTexture(gl.TEXTURE_2D, gl.createTexture());
gl.texImage2D(gl.TEXTURE_2D, 0, gl.RGBA16F, 1, 1, 0, gl.RGBA, gl.HALF_FLOAT, new Uint16Array(pixel.buffer));
console.log(gl.getError() === gl.NO_ERROR); // true

精度

16bitで表せる桁は少ないので、Float32ArrayやFloat64Arrayの値を入れると、近い値に丸められます。

js
const f64 = new Float64Array([0.3333]);
console.log(f64[0]); // 0.3333
const f32 = new Float32Array([0.3333]);
console.log(f32[0]); // 0.33329999446868896
const f16 = new Float16Array(f64);
console.log(f16[0]); // 0.333251953125

丸められた値は、Float64Arrayに入れ直しても0.3333には戻りません。

取り出した値の型

Float16Arrayから取り出した値は、ただのnumberです。

js
const f16 = new Float16Array([1 / 3]);
const value = f16[0];
console.log(value); // 0.333251953125(16bitで丸められた値)
console.log(typeof value); // 'number'
console.log(value * 3); // 0.999755859375

取り出したあとの計算は、ほかのnumberと同じく64bitで行われます。16bitに丸められるのは、Float16Arrayに入れたときだけです。

Math.f16roundとDataView

同じ機能で、Math.f16round()と、DataViewのgetFloat16()とsetFloat16()も入りました。

Math.f16round()は、配列を作らずに、数を16bitの浮動小数点数で表せる一番近い値に丸めます。Float16Arrayに入れたときにどの値になるかを、先に確かめられます。

js
console.log(Math.f16round(0.3333)); // 0.333251953125
console.log(Math.f16round(65520)); // Infinity

Float16Arrayは、バッファの2の倍数のバイト位置からしか作れません。ファイルや通信で受け取ったバイト列の、奇数の位置にある16bitの浮動小数点数は、DataViewで読みます。

ファイルや通信のバイト列では、2バイト以上の数を並べる順番が形式ごとに決まっています。上位のバイトを先に置くのがビッグエンディアン、下位のバイトを先に置くのがリトルエンディアンで、1.5(16bitで0x3E00)はそれぞれ3E 00と00 3Eの順に並びます。順番を取り違えると、別の数として読んでしまいます。DataViewは第3引数を省くとビッグエンディアンで読むので、リトルエンディアンの形式を読むときはtrueを渡します。

js
const view = new DataView(new ArrayBuffer(5));
view.setFloat16(1, 1.5, true); // リトルエンディアンで00 3Eと書く
console.log(view.getFloat16(1, true)); // 1.5
console.log(view.getFloat16(1)); // 0.0000036954879760742188(ビッグエンディアンとして読んだ)
// RangeError(1は2の倍数ではない)
new Float16Array(view.buffer, 1);

Float16Arrayは、動いている環境の順番で読みます。多くの環境はリトルエンディアンなので、ビッグエンディアンの形式は、位置が2の倍数でもDataViewで読みます。

読み書きの速さ

読み書きの速さは、ブラウザによって分かれます。乱数を入れた500万要素の配列をforで読んで足すと、ChromeとSafariではFloat16Arrayの方がFloat32Arrayより速く、Firefoxでは遅くなります。JavaScriptの中で計算するために、メモリの節約だけを目当てにFloat16Arrayを選ぶと、精度を落としたうえに遅くなることもあります。

おわりに

Float16Arrayを使うと、WebGPUや機械学習のモデルが16bitの浮動小数点数で受け渡すデータを、ビットを組み立てずに読み書きできます。扱える範囲は±65,504で精度も落ちるので、JavaScriptの中で計算するだけならFloat32ArrayやFloat64Arrayを使います。