{ "__type": "IngestedDoc", "__tag": 4010, "_content": {}, "_ordered_sections": [], "item_file": null, "item_line": null, "item_type": null, "aliases": [], "example_section_data": { "__type": "Section", "__tag": 4015, "children": [], "title": [], "level": 0, "target": null }, "see_also": [], "signature": null, "references": null, "qa": "reference:simd:build-options", "arbitrary": [ { "__type": "Section", "__tag": 4015, "children": [], "title": [ { "__type": "Text", "__tag": 4046, "value": "CPU Build Options" } ], "level": 0, "target": null }, { "__type": "Section", "__tag": 4015, "children": [ { "__type": "Paragraph", "__tag": 4045, "children": [ { "__type": "Text", "__tag": 4046, "value": "NumPy provides configuration options to optimize performance based on CPU capabilities. These options allow you to specify which CPU features to support, balancing performance, compatibility, and binary size. This document explains how to use these options effectively across various CPU architectures." } ] } ], "title": [ { "__type": "Text", "__tag": 4046, "value": "Overview" } ], "level": 1, "target": null }, { "__type": "Section", "__tag": 4015, "children": [ { "__type": "Paragraph", "__tag": 4045, "children": [ { "__type": "Text", "__tag": 4046, "value": "NumPy uses several build options to control CPU optimizations:" } ] }, { "__type": "BulletList", "__tag": 4053, "ordered": false, "start": 1, "children": [ { "__type": "ListItem", "__tag": 4054, "children": [ { "__type": "Paragraph", "__tag": 4045, "children": [ { "__type": "InlineCode", "__tag": 4051, "value": "cpu-baseline" }, { "__type": "Text", "__tag": 4046, "value": ": The minimum set of CPU features required to run the compiled NumPy." } ] }, { "__type": "BulletList", "__tag": 4053, "ordered": false, "start": 1, "children": [ { "__type": "ListItem", "__tag": 4054, "children": [ { "__type": "Paragraph", "__tag": 4045, "children": [ { "__type": "Text", "__tag": 4046, "value": "Default: " }, { "__type": "InlineCode", "__tag": 4051, "value": "min" }, { "__type": "Text", "__tag": 4046, "value": " (provides compatibility across a wide range of platforms)" } ] } ] }, { "__type": "ListItem", "__tag": 4054, "children": [ { "__type": "Paragraph", "__tag": 4045, "children": [ { "__type": "Text", "__tag": 4046, "value": "If your target CPU doesn't support all specified baseline features, NumPy will fail to load with a Python runtime error" } ] } ] } ] } ] }, { "__type": "ListItem", "__tag": 4054, "children": [ { "__type": "Paragraph", "__tag": 4045, "children": [ { "__type": "InlineCode", "__tag": 4051, "value": "cpu-baseline-detect" }, { "__type": "Text", "__tag": 4046, "value": ": controls detection of CPU baseline based on compiler flags. Default value is " }, { "__type": "InlineCode", "__tag": 4051, "value": "auto" }, { "__type": "Text", "__tag": 4046, "value": " that enables detection if " }, { "__type": "InlineCode", "__tag": 4051, "value": "-march=" }, { "__type": "Text", "__tag": 4046, "value": " or a similar compiler flag is used. The other possible values are " }, { "__type": "InlineCode", "__tag": 4051, "value": "enabled" }, { "__type": "Text", "__tag": 4046, "value": " and " }, { "__type": "InlineCode", "__tag": 4051, "value": "disabled" }, { "__type": "Text", "__tag": 4046, "value": " to respective enable or disable it unconditionally." } ] } ] }, { "__type": "ListItem", "__tag": 4054, "children": [ { "__type": "Paragraph", "__tag": 4045, "children": [ { "__type": "InlineCode", "__tag": 4051, "value": "cpu-dispatch" }, { "__type": "Text", "__tag": 4046, "value": ": Additional CPU features for which optimized code paths will be generated." } ] }, { "__type": "BulletList", "__tag": 4053, "ordered": false, "start": 1, "children": [ { "__type": "ListItem", "__tag": 4054, "children": [ { "__type": "Paragraph", "__tag": 4045, "children": [ { "__type": "Text", "__tag": 4046, "value": "Default: " }, { "__type": "InlineCode", "__tag": 4051, "value": "max" }, { "__type": "Text", "__tag": 4046, "value": " (enables all available optimizations)" } ] } ] }, { "__type": "ListItem", "__tag": 4054, "children": [ { "__type": "Paragraph", "__tag": 4045, "children": [ { "__type": "Text", "__tag": 4046, "value": "At runtime, NumPy will automatically select the fastest available code path based on your CPU's capabilities" } ] } ] } ] } ] }, { "__type": "ListItem", "__tag": 4054, "children": [ { "__type": "Paragraph", "__tag": 4045, "children": [ { "__type": "InlineCode", "__tag": 4051, "value": "disable-optimization" }, { "__type": "Text", "__tag": 4046, "value": ": Completely disables all CPU optimizations." } ] }, { "__type": "BulletList", "__tag": 4053, "ordered": false, "start": 1, "children": [ { "__type": "ListItem", "__tag": 4054, "children": [ { "__type": "Paragraph", "__tag": 4045, "children": [ { "__type": "Text", "__tag": 4046, "value": "Default: " }, { "__type": "InlineCode", "__tag": 4051, "value": "false" }, { "__type": "Text", "__tag": 4046, "value": " (optimizations are enabled)" } ] } ] }, { "__type": "ListItem", "__tag": 4054, "children": [ { "__type": "Paragraph", "__tag": 4045, "children": [ { "__type": "Text", "__tag": 4046, "value": "When set to " }, { "__type": "InlineCode", "__tag": 4051, "value": "true" }, { "__type": "Text", "__tag": 4046, "value": ", disables all CPU optimized code including dispatch, SIMD, and loop unrolling" } ] } ] }, { "__type": "ListItem", "__tag": 4054, "children": [ { "__type": "Paragraph", "__tag": 4045, "children": [ { "__type": "Text", "__tag": 4046, "value": "Useful for debugging, testing, or in environments where optimization causes issues" } ] } ] } ] } ] } ] }, { "__type": "Paragraph", "__tag": 4045, "children": [ { "__type": "Text", "__tag": 4046, "value": "These options are specified at build time via meson-python arguments " } ] }, { "__type": "Code", "__tag": 4050, "value": "pip install . -Csetup-args=-Dcpu-baseline=\"min\" -Csetup-args=-Dcpu-dispatch=\"max\"\n# or through spin\nspin build -- -Dcpu-baseline=\"min\" -Dcpu-dispatch=\"max\"", "execution_status": null }, { "__type": "Paragraph", "__tag": 4045, "children": [ { "__type": "InlineCode", "__tag": 4051, "value": "cpu-baseline" }, { "__type": "Text", "__tag": 4046, "value": " and " }, { "__type": "InlineCode", "__tag": 4051, "value": "cpu-dispatch" }, { "__type": "Text", "__tag": 4046, "value": " can be set to specific " }, { "__type": "InlineRole", "__tag": 4003, "value": "CPU groups, features", "domain": null, "role": "ref", "inventory": null }, { "__type": "Text", "__tag": 4046, "value": ", or " }, { "__type": "CrossRef", "__tag": 4002, "value": "special options", "reference": { "__type": "LocalRef", "__tag": 4022, "kind": "docs", "path": "reference:simd:build-options" }, "kind": "exists" }, { "__type": "Text", "__tag": 4046, "value": " that perform specific actions. The following sections describe these options in detail." } ] } ], "title": [ { "__type": "Text", "__tag": 4046, "value": "Key Configuration Options" } ], "level": 1, "target": null }, { "__type": "Section", "__tag": 4015, "children": [], "title": [ { "__type": "Text", "__tag": 4046, "value": "Common Usage Scenarios" } ], "level": 1, "target": null }, { "__type": "Section", "__tag": 4015, "children": [ { "__type": "Paragraph", "__tag": 4045, "children": [ { "__type": "Text", "__tag": 4046, "value": "When building for your machine only and not planning to distribute " } ] }, { "__type": "Code", "__tag": 4050, "value": "python -m build --wheel -Csetup-args=-Dcpu-baseline=\"native\" -Csetup-args=-Dcpu-dispatch=\"none\"", "execution_status": null }, { "__type": "Paragraph", "__tag": 4045, "children": [ { "__type": "Text", "__tag": 4046, "value": "This automatically detects and uses all CPU features available on your machine." } ] }, { "__type": "Admonition", "__tag": 4056, "kind": "note", "base_type": "note", "children": [ { "__type": "AdmonitionTitle", "__tag": 4055, "children": [ { "__type": "Text", "__tag": 4046, "value": "note " } ] }, { "__type": "Paragraph", "__tag": 4045, "children": [ { "__type": "Text", "__tag": 4046, "value": "A fatal error will be raised if " }, { "__type": "InlineCode", "__tag": 4051, "value": "native" }, { "__type": "Text", "__tag": 4046, "value": " isn't supported by the host platform." } ] } ] } ], "title": [ { "__type": "Text", "__tag": 4046, "value": "Building for Local Use Only" } ], "level": 2, "target": null }, { "__type": "Section", "__tag": 4015, "children": [ { "__type": "Paragraph", "__tag": 4045, "children": [ { "__type": "Text", "__tag": 4046, "value": "You may want to exclude certain CPU features from the dispatched features " } ] }, { "__type": "Code", "__tag": 4050, "value": "# For x86-64: exclude all AVX-512 features\npython -m build --wheel -Csetup-args=-Dcpu-dispatch=\"max -X86_V4\"\n\n# For ARM64: exclude SVE\npython -m build --wheel -Csetup-args=-Dcpu-dispatch=\"max -SVE\"", "execution_status": null }, { "__type": "Admonition", "__tag": 4056, "kind": "note", "base_type": "note", "children": [ { "__type": "AdmonitionTitle", "__tag": 4055, "children": [ { "__type": "Text", "__tag": 4046, "value": "note " } ] }, { "__type": "Paragraph", "__tag": 4045, "children": [ { "__type": "Text", "__tag": 4046, "value": "Excluding a feature will also exclude any successor features that are implied by the excluded feature. For example, excluding " }, { "__type": "InlineCode", "__tag": 4051, "value": "X86_V4" }, { "__type": "Text", "__tag": 4046, "value": " will exclude " }, { "__type": "InlineCode", "__tag": 4051, "value": "AVX512_ICL" }, { "__type": "Text", "__tag": 4046, "value": " and " }, { "__type": "InlineCode", "__tag": 4051, "value": "AVX512_SPR" }, { "__type": "Text", "__tag": 4046, "value": " as well." } ] } ] } ], "title": [ { "__type": "Text", "__tag": 4046, "value": "Excluding Specific Features" } ], "level": 2, "target": null }, { "__type": "Section", "__tag": 4015, "children": [ { "__type": "Paragraph", "__tag": 4045, "children": [ { "__type": "Text", "__tag": 4046, "value": "On " }, { "__type": "InlineCode", "__tag": 4051, "value": "x86-64" }, { "__type": "Text", "__tag": 4046, "value": ", by default the baseline is set to " }, { "__type": "InlineCode", "__tag": 4051, "value": "min" }, { "__type": "Text", "__tag": 4046, "value": " which maps to " }, { "__type": "InlineCode", "__tag": 4051, "value": "X86_V2" }, { "__type": "Text", "__tag": 4046, "value": ". This unsuitable for older CPUs (before 2009) or old virtual machines. To address this, set the baseline to " }, { "__type": "InlineCode", "__tag": 4051, "value": "none" }, { "__type": "Text", "__tag": 4046, "value": " " } ] }, { "__type": "Code", "__tag": 4050, "value": "python -m build --wheel -Csetup-args=-Dcpu-baseline=\"none\"", "execution_status": null }, { "__type": "Paragraph", "__tag": 4045, "children": [ { "__type": "Text", "__tag": 4046, "value": "This will create a build that is compatible with all x86 CPUs, but without any manual optimizations or SIMD code paths for the baseline. The build will rely only on dispatched code paths for optimization." } ] } ], "title": [ { "__type": "Text", "__tag": 4046, "value": "Targeting Older CPUs" } ], "level": 2, "target": null }, { "__type": "Section", "__tag": 4015, "children": [ { "__type": "Paragraph", "__tag": 4045, "children": [ { "__type": "Text", "__tag": 4046, "value": "Raising the baseline improves performance for two main reasons:" } ] }, { "__type": "BulletList", "__tag": 4053, "ordered": true, "start": 1, "children": [ { "__type": "ListItem", "__tag": 4054, "children": [ { "__type": "Paragraph", "__tag": 4045, "children": [ { "__type": "Text", "__tag": 4046, "value": "Dispatched kernels don't cover all code paths" } ] } ] }, { "__type": "ListItem", "__tag": 4054, "children": [ { "__type": "Paragraph", "__tag": 4045, "children": [ { "__type": "Text", "__tag": 4046, "value": "A higher baseline leads to smaller binary size as the compiler won't generate code paths for excluded dispatched features" } ] } ] } ] }, { "__type": "Paragraph", "__tag": 4045, "children": [ { "__type": "Text", "__tag": 4046, "value": "For CPUs from 2015 and newer, setting the baseline to " }, { "__type": "InlineCode", "__tag": 4051, "value": "X86_V3" }, { "__type": "Text", "__tag": 4046, "value": " may be suitable " } ] }, { "__type": "Code", "__tag": 4050, "value": "python -m build --wheel -Csetup-args=-Dcpu-baseline=\"min+X86_V3\"", "execution_status": null } ], "title": [ { "__type": "Text", "__tag": 4046, "value": "Targeting Newer CPUs" } ], "level": 2, "target": null }, { "__type": "Section", "__tag": 4015, "children": [ { "__type": "Paragraph", "__tag": 4045, "children": [ { "__type": "Text", "__tag": 4046, "value": "NumPy supports optimized code paths for multiple CPU architectures. Below are the supported feature groups for each architecture. The name of the feature group can be used in the build options " }, { "__type": "InlineCode", "__tag": 4051, "value": "cpu-baseline" }, { "__type": "Text", "__tag": 4046, "value": " and " }, { "__type": "InlineCode", "__tag": 4051, "value": "cpu-dispatch" }, { "__type": "Text", "__tag": 4046, "value": "." } ] } ], "title": [ { "__type": "Text", "__tag": 4046, "value": "Supported CPU Features By Architecture" } ], "level": 1, "target": "opt-supported-features" }, { "__type": "Section", "__tag": 4015, "children": [ { "__type": "Table", "__tag": 4065, "children": [ { "__type": "TableRow", "__tag": 4068, "header": true, "children": [ { "__type": "TableCell", "__tag": 4069, "children": [ { "__type": "Paragraph", "__tag": 4045, "children": [ { "__type": "Text", "__tag": 4046, "value": "Name" } ] } ] }, { "__type": "TableCell", "__tag": 4069, "children": [ { "__type": "Paragraph", "__tag": 4045, "children": [ { "__type": "Text", "__tag": 4046, "value": "Implies" } ] } ] }, { "__type": "TableCell", "__tag": 4069, "children": [ { "__type": "Paragraph", "__tag": 4045, "children": [ { "__type": "Text", "__tag": 4046, "value": "Includes" } ] } ] } ] }, { "__type": "TableRow", "__tag": 4068, "header": false, "children": [ { "__type": "TableCell", "__tag": 4069, "children": [ { "__type": "Paragraph", "__tag": 4045, "children": [ { "__type": "InlineCode", "__tag": 4051, "value": "X86_V2" } ] } ] }, { "__type": "TableCell", "__tag": 4069, "children": [] }, { "__type": "TableCell", "__tag": 4069, "children": [ { "__type": "Paragraph", "__tag": 4045, "children": [ { "__type": "InlineCode", "__tag": 4051, "value": "SSE" }, { "__type": "Text", "__tag": 4046, "value": " " }, { "__type": "InlineCode", "__tag": 4051, "value": "SSE2" }, { "__type": "Text", "__tag": 4046, "value": " " }, { "__type": "InlineCode", "__tag": 4051, "value": "SSE3" }, { "__type": "Text", "__tag": 4046, "value": " " }, { "__type": "InlineCode", "__tag": 4051, "value": "SSSE3" }, { "__type": "Text", "__tag": 4046, "value": " " }, { "__type": "InlineCode", "__tag": 4051, "value": "SSE4_1" }, { "__type": "Text", "__tag": 4046, "value": " " }, { "__type": "InlineCode", "__tag": 4051, "value": "SSE4_2" }, { "__type": "Text", "__tag": 4046, "value": " " }, { "__type": "InlineCode", "__tag": 4051, "value": "POPCNT" }, { "__type": "Text", "__tag": 4046, "value": " " }, { "__type": "InlineCode", "__tag": 4051, "value": "CX16" }, { "__type": "Text", "__tag": 4046, "value": " " }, { "__type": "InlineCode", "__tag": 4051, "value": "LAHF" } ] } ] } ] }, { "__type": "TableRow", "__tag": 4068, "header": false, "children": [ { "__type": "TableCell", "__tag": 4069, "children": [ { "__type": "Paragraph", "__tag": 4045, "children": [ { "__type": "InlineCode", "__tag": 4051, "value": "X86_V3" } ] } ] }, { "__type": "TableCell", "__tag": 4069, "children": [ { "__type": "Paragraph", "__tag": 4045, "children": [ { "__type": "InlineCode", "__tag": 4051, "value": "X86_V2" } ] } ] }, { "__type": "TableCell", "__tag": 4069, "children": [ { "__type": "Paragraph", "__tag": 4045, "children": [ { "__type": "InlineCode", "__tag": 4051, "value": "AVX" }, { "__type": "Text", "__tag": 4046, "value": " " }, { "__type": "InlineCode", "__tag": 4051, "value": "AVX2" }, { "__type": "Text", "__tag": 4046, "value": " " }, { "__type": "InlineCode", "__tag": 4051, "value": "FMA3" }, { "__type": "Text", "__tag": 4046, "value": " " }, { "__type": "InlineCode", "__tag": 4051, "value": "BMI" }, { "__type": "Text", "__tag": 4046, "value": " " }, { "__type": "InlineCode", "__tag": 4051, "value": "BMI2" }, { "__type": "Text", "__tag": 4046, "value": " " }, { "__type": "InlineCode", "__tag": 4051, "value": "LZCNT" }, { "__type": "Text", "__tag": 4046, "value": " " }, { "__type": "InlineCode", "__tag": 4051, "value": "F16C" }, { "__type": "Text", "__tag": 4046, "value": " " }, { "__type": "InlineCode", "__tag": 4051, "value": "MOVBE" } ] } ] } ] }, { "__type": "TableRow", "__tag": 4068, "header": false, "children": [ { "__type": "TableCell", "__tag": 4069, "children": [ { "__type": "Paragraph", "__tag": 4045, "children": [ { "__type": "InlineCode", "__tag": 4051, "value": "X86_V4" } ] } ] }, { "__type": "TableCell", "__tag": 4069, "children": [ { "__type": "Paragraph", "__tag": 4045, "children": [ { "__type": "InlineCode", "__tag": 4051, "value": "X86_V3" } ] } ] }, { "__type": "TableCell", "__tag": 4069, "children": [ { "__type": "Paragraph", "__tag": 4045, "children": [ { "__type": "InlineCode", "__tag": 4051, "value": "AVX512F" }, { "__type": "Text", "__tag": 4046, "value": " " }, { "__type": "InlineCode", "__tag": 4051, "value": "AVX512CD" }, { "__type": "Text", "__tag": 4046, "value": " " }, { "__type": "InlineCode", "__tag": 4051, "value": "AVX512VL" }, { "__type": "Text", "__tag": 4046, "value": " " }, { "__type": "InlineCode", "__tag": 4051, "value": "AVX512BW" }, { "__type": "Text", "__tag": 4046, "value": " " }, { "__type": "InlineCode", "__tag": 4051, "value": "AVX512DQ" } ] } ] } ] }, { "__type": "TableRow", "__tag": 4068, "header": false, "children": [ { "__type": "TableCell", "__tag": 4069, "children": [ { "__type": "Paragraph", "__tag": 4045, "children": [ { "__type": "InlineCode", "__tag": 4051, "value": "AVX512_ICL" } ] } ] }, { "__type": "TableCell", "__tag": 4069, "children": [ { "__type": "Paragraph", "__tag": 4045, "children": [ { "__type": "InlineCode", "__tag": 4051, "value": "X86_V4" } ] } ] }, { "__type": "TableCell", "__tag": 4069, "children": [ { "__type": "Paragraph", "__tag": 4045, "children": [ { "__type": "InlineCode", "__tag": 4051, "value": "AVX512VBMI" }, { "__type": "Text", "__tag": 4046, "value": " " }, { "__type": "InlineCode", "__tag": 4051, "value": "AVX512VBMI2" }, { "__type": "Text", "__tag": 4046, "value": " " }, { "__type": "InlineCode", "__tag": 4051, "value": "AVX512VNNI" }, { "__type": "Text", "__tag": 4046, "value": " " }, { "__type": "InlineCode", "__tag": 4051, "value": "AVX512BITALG" }, { "__type": "Text", "__tag": 4046, "value": " " }, { "__type": "InlineCode", "__tag": 4051, "value": "AVX512VPOPCNTDQ" }, { "__type": "Text", "__tag": 4046, "value": " " }, { "__type": "InlineCode", "__tag": 4051, "value": "AVX512IFMA" }, { "__type": "Text", "__tag": 4046, "value": " " }, { "__type": "InlineCode", "__tag": 4051, "value": "VAES" }, { "__type": "Text", "__tag": 4046, "value": " " }, { "__type": "InlineCode", "__tag": 4051, "value": "GFNI" }, { "__type": "Text", "__tag": 4046, "value": " " }, { "__type": "InlineCode", "__tag": 4051, "value": "VPCLMULQDQ" } ] } ] } ] }, { "__type": "TableRow", "__tag": 4068, "header": false, "children": [ { "__type": "TableCell", "__tag": 4069, "children": [ { "__type": "Paragraph", "__tag": 4045, "children": [ { "__type": "InlineCode", "__tag": 4051, "value": "AVX512_SPR" } ] } ] }, { "__type": "TableCell", "__tag": 4069, "children": [ { "__type": "Paragraph", "__tag": 4045, "children": [ { "__type": "InlineCode", "__tag": 4051, "value": "AVX512_ICL" } ] } ] }, { "__type": "TableCell", "__tag": 4069, "children": [ { "__type": "Paragraph", "__tag": 4045, "children": [ { "__type": "InlineCode", "__tag": 4051, "value": "AVX512FP16" } ] } ] } ] } ] }, { "__type": "Paragraph", "__tag": 4045, "children": [ { "__type": "Text", "__tag": 4046, "value": "These groups correspond to CPU generations:" } ] }, { "__type": "BulletList", "__tag": 4053, "ordered": false, "start": 1, "children": [ { "__type": "ListItem", "__tag": 4054, "children": [ { "__type": "Paragraph", "__tag": 4045, "children": [ { "__type": "InlineCode", "__tag": 4051, "value": "X86_V2" }, { "__type": "Text", "__tag": 4046, "value": ": x86-64-v2 microarchitectures (CPUs since 2009)" } ] } ] }, { "__type": "ListItem", "__tag": 4054, "children": [ { "__type": "Paragraph", "__tag": 4045, "children": [ { "__type": "InlineCode", "__tag": 4051, "value": "X86_V3" }, { "__type": "Text", "__tag": 4046, "value": ": x86-64-v3 microarchitectures (CPUs since 2015)" } ] } ] }, { "__type": "ListItem", "__tag": 4054, "children": [ { "__type": "Paragraph", "__tag": 4045, "children": [ { "__type": "InlineCode", "__tag": 4051, "value": "X86_V4" }, { "__type": "Text", "__tag": 4046, "value": ": x86-64-v4 microarchitectures (AVX-512 capable CPUs)" } ] } ] }, { "__type": "ListItem", "__tag": 4054, "children": [ { "__type": "Paragraph", "__tag": 4045, "children": [ { "__type": "InlineCode", "__tag": 4051, "value": "AVX512_ICL" }, { "__type": "Text", "__tag": 4046, "value": ": Intel Ice Lake and similar CPUs" } ] } ] }, { "__type": "ListItem", "__tag": 4054, "children": [ { "__type": "Paragraph", "__tag": 4045, "children": [ { "__type": "InlineCode", "__tag": 4051, "value": "AVX512_SPR" }, { "__type": "Text", "__tag": 4046, "value": ": Intel Sapphire Rapids and newer CPUs" } ] } ] } ] }, { "__type": "Admonition", "__tag": 4056, "kind": "note", "base_type": "note", "children": [ { "__type": "AdmonitionTitle", "__tag": 4055, "children": [ { "__type": "Text", "__tag": 4046, "value": "note " } ] }, { "__type": "Paragraph", "__tag": 4045, "children": [ { "__type": "Text", "__tag": 4046, "value": "On 32-bit x86, " }, { "__type": "InlineCode", "__tag": 4051, "value": "cx16" }, { "__type": "Text", "__tag": 4046, "value": " is excluded from " }, { "__type": "InlineCode", "__tag": 4051, "value": "X86_V2" }, { "__type": "Text", "__tag": 4046, "value": "." } ] } ] } ], "title": [ { "__type": "Text", "__tag": 4046, "value": "X86" } ], "level": 2, "target": null }, { "__type": "Section", "__tag": 4015, "children": [ { "__type": "Table", "__tag": 4065, "children": [ { "__type": "TableRow", "__tag": 4068, "header": true, "children": [ { "__type": "TableCell", "__tag": 4069, "children": [ { "__type": "Paragraph", "__tag": 4045, "children": [ { "__type": "Text", "__tag": 4046, "value": "Name" } ] } ] }, { "__type": "TableCell", "__tag": 4069, "children": [ { "__type": "Paragraph", "__tag": 4045, "children": [ { "__type": "Text", "__tag": 4046, "value": "Implies" } ] } ] } ] }, { "__type": "TableRow", "__tag": 4068, "header": false, "children": [ { "__type": "TableCell", "__tag": 4069, "children": [ { "__type": "Paragraph", "__tag": 4045, "children": [ { "__type": "InlineCode", "__tag": 4051, "value": "VSX" } ] } ] }, { "__type": "TableCell", "__tag": 4069, "children": [] } ] }, { "__type": "TableRow", "__tag": 4068, "header": false, "children": [ { "__type": "TableCell", "__tag": 4069, "children": [ { "__type": "Paragraph", "__tag": 4045, "children": [ { "__type": "InlineCode", "__tag": 4051, "value": "VSX2" } ] } ] }, { "__type": "TableCell", "__tag": 4069, "children": [ { "__type": "Paragraph", "__tag": 4045, "children": [ { "__type": "InlineCode", "__tag": 4051, "value": "VSX" } ] } ] } ] }, { "__type": "TableRow", "__tag": 4068, "header": false, "children": [ { "__type": "TableCell", "__tag": 4069, "children": [ { "__type": "Paragraph", "__tag": 4045, "children": [ { "__type": "InlineCode", "__tag": 4051, "value": "VSX3" } ] } ] }, { "__type": "TableCell", "__tag": 4069, "children": [ { "__type": "Paragraph", "__tag": 4045, "children": [ { "__type": "InlineCode", "__tag": 4051, "value": "VSX" }, { "__type": "Text", "__tag": 4046, "value": " " }, { "__type": "InlineCode", "__tag": 4051, "value": "VSX2" } ] } ] } ] }, { "__type": "TableRow", "__tag": 4068, "header": false, "children": [ { "__type": "TableCell", "__tag": 4069, "children": [ { "__type": "Paragraph", "__tag": 4045, "children": [ { "__type": "InlineCode", "__tag": 4051, "value": "VSX4" } ] } ] }, { "__type": "TableCell", "__tag": 4069, "children": [ { "__type": "Paragraph", "__tag": 4045, "children": [ { "__type": "InlineCode", "__tag": 4051, "value": "VSX" }, { "__type": "Text", "__tag": 4046, "value": " " }, { "__type": "InlineCode", "__tag": 4051, "value": "VSX2" }, { "__type": "Text", "__tag": 4046, "value": " " }, { "__type": "InlineCode", "__tag": 4051, "value": "VSX3" } ] } ] } ] } ] } ], "title": [ { "__type": "Text", "__tag": 4046, "value": "On IBM/POWER big-endian" } ], "level": 2, "target": null }, { "__type": "Section", "__tag": 4015, "children": [ { "__type": "Table", "__tag": 4065, "children": [ { "__type": "TableRow", "__tag": 4068, "header": true, "children": [ { "__type": "TableCell", "__tag": 4069, "children": [ { "__type": "Paragraph", "__tag": 4045, "children": [ { "__type": "Text", "__tag": 4046, "value": "Name" } ] } ] }, { "__type": "TableCell", "__tag": 4069, "children": [ { "__type": "Paragraph", "__tag": 4045, "children": [ { "__type": "Text", "__tag": 4046, "value": "Implies" } ] } ] } ] }, { "__type": "TableRow", "__tag": 4068, "header": false, "children": [ { "__type": "TableCell", "__tag": 4069, "children": [ { "__type": "Paragraph", "__tag": 4045, "children": [ { "__type": "InlineCode", "__tag": 4051, "value": "VSX" } ] } ] }, { "__type": "TableCell", "__tag": 4069, "children": [ { "__type": "Paragraph", "__tag": 4045, "children": [ { "__type": "InlineCode", "__tag": 4051, "value": "VSX2" } ] } ] } ] }, { "__type": "TableRow", "__tag": 4068, "header": false, "children": [ { "__type": "TableCell", "__tag": 4069, "children": [ { "__type": "Paragraph", "__tag": 4045, "children": [ { "__type": "InlineCode", "__tag": 4051, "value": "VSX2" } ] } ] }, { "__type": "TableCell", "__tag": 4069, "children": [ { "__type": "Paragraph", "__tag": 4045, "children": [ { "__type": "InlineCode", "__tag": 4051, "value": "VSX" } ] } ] } ] }, { "__type": "TableRow", "__tag": 4068, "header": false, "children": [ { "__type": "TableCell", "__tag": 4069, "children": [ { "__type": "Paragraph", "__tag": 4045, "children": [ { "__type": "InlineCode", "__tag": 4051, "value": "VSX3" } ] } ] }, { "__type": "TableCell", "__tag": 4069, "children": [ { "__type": "Paragraph", "__tag": 4045, "children": [ { "__type": "InlineCode", "__tag": 4051, "value": "VSX" }, { "__type": "Text", "__tag": 4046, "value": " " }, { "__type": "InlineCode", "__tag": 4051, "value": "VSX2" } ] } ] } ] }, { "__type": "TableRow", "__tag": 4068, "header": false, "children": [ { "__type": "TableCell", "__tag": 4069, "children": [ { "__type": "Paragraph", "__tag": 4045, "children": [ { "__type": "InlineCode", "__tag": 4051, "value": "VSX4" } ] } ] }, { "__type": "TableCell", "__tag": 4069, "children": [ { "__type": "Paragraph", "__tag": 4045, "children": [ { "__type": "InlineCode", "__tag": 4051, "value": "VSX" }, { "__type": "Text", "__tag": 4046, "value": " " }, { "__type": "InlineCode", "__tag": 4051, "value": "VSX2" }, { "__type": "Text", "__tag": 4046, "value": " " }, { "__type": "InlineCode", "__tag": 4051, "value": "VSX3" } ] } ] } ] } ] } ], "title": [ { "__type": "Text", "__tag": 4046, "value": "On IBM/POWER little-endian" } ], "level": 2, "target": null }, { "__type": "Section", "__tag": 4015, "children": [ { "__type": "Table", "__tag": 4065, "children": [ { "__type": "TableRow", "__tag": 4068, "header": true, "children": [ { "__type": "TableCell", "__tag": 4069, "children": [ { "__type": "Paragraph", "__tag": 4045, "children": [ { "__type": "Text", "__tag": 4046, "value": "Name" } ] } ] }, { "__type": "TableCell", "__tag": 4069, "children": [ { "__type": "Paragraph", "__tag": 4045, "children": [ { "__type": "Text", "__tag": 4046, "value": "Implies" } ] } ] } ] }, { "__type": "TableRow", "__tag": 4068, "header": false, "children": [ { "__type": "TableCell", "__tag": 4069, "children": [ { "__type": "Paragraph", "__tag": 4045, "children": [ { "__type": "InlineCode", "__tag": 4051, "value": "NEON" } ] } ] }, { "__type": "TableCell", "__tag": 4069, "children": [] } ] }, { "__type": "TableRow", "__tag": 4068, "header": false, "children": [ { "__type": "TableCell", "__tag": 4069, "children": [ { "__type": "Paragraph", "__tag": 4045, "children": [ { "__type": "InlineCode", "__tag": 4051, "value": "NEON_FP16" } ] } ] }, { "__type": "TableCell", "__tag": 4069, "children": [ { "__type": "Paragraph", "__tag": 4045, "children": [ { "__type": "InlineCode", "__tag": 4051, "value": "NEON" } ] } ] } ] }, { "__type": "TableRow", "__tag": 4068, "header": false, "children": [ { "__type": "TableCell", "__tag": 4069, "children": [ { "__type": "Paragraph", "__tag": 4045, "children": [ { "__type": "InlineCode", "__tag": 4051, "value": "NEON_VFPV4" } ] } ] }, { "__type": "TableCell", "__tag": 4069, "children": [ { "__type": "Paragraph", "__tag": 4045, "children": [ { "__type": "InlineCode", "__tag": 4051, "value": "NEON" }, { "__type": "Text", "__tag": 4046, "value": " " }, { "__type": "InlineCode", "__tag": 4051, "value": "NEON_FP16" } ] } ] } ] }, { "__type": "TableRow", "__tag": 4068, "header": false, "children": [ { "__type": "TableCell", "__tag": 4069, "children": [ { "__type": "Paragraph", "__tag": 4045, "children": [ { "__type": "InlineCode", "__tag": 4051, "value": "ASIMD" } ] } ] }, { "__type": "TableCell", "__tag": 4069, "children": [ { "__type": "Paragraph", "__tag": 4045, "children": [ { "__type": "InlineCode", "__tag": 4051, "value": "NEON" }, { "__type": "Text", "__tag": 4046, "value": " " }, { "__type": "InlineCode", "__tag": 4051, "value": "NEON_FP16" }, { "__type": "Text", "__tag": 4046, "value": " " }, { "__type": "InlineCode", "__tag": 4051, "value": "NEON_VFPV4" } ] } ] } ] }, { "__type": "TableRow", "__tag": 4068, "header": false, "children": [ { "__type": "TableCell", "__tag": 4069, "children": [ { "__type": "Paragraph", "__tag": 4045, "children": [ { "__type": "InlineCode", "__tag": 4051, "value": "ASIMDHP" } ] } ] }, { "__type": "TableCell", "__tag": 4069, "children": [ { "__type": "Paragraph", "__tag": 4045, "children": [ { "__type": "InlineCode", "__tag": 4051, "value": "NEON" }, { "__type": "Text", "__tag": 4046, "value": " " }, { "__type": "InlineCode", "__tag": 4051, "value": "NEON_FP16" }, { "__type": "Text", "__tag": 4046, "value": " " }, { "__type": "InlineCode", "__tag": 4051, "value": "NEON_VFPV4" }, { "__type": "Text", "__tag": 4046, "value": " " }, { "__type": "InlineCode", "__tag": 4051, "value": "ASIMD" } ] } ] } ] }, { "__type": "TableRow", "__tag": 4068, "header": false, "children": [ { "__type": "TableCell", "__tag": 4069, "children": [ { "__type": "Paragraph", "__tag": 4045, "children": [ { "__type": "InlineCode", "__tag": 4051, "value": "ASIMDDP" } ] } ] }, { "__type": "TableCell", "__tag": 4069, "children": [ { "__type": "Paragraph", "__tag": 4045, "children": [ { "__type": "InlineCode", "__tag": 4051, "value": "NEON" }, { "__type": "Text", "__tag": 4046, "value": " " }, { "__type": "InlineCode", "__tag": 4051, "value": "NEON_FP16" }, { "__type": "Text", "__tag": 4046, "value": " " }, { "__type": "InlineCode", "__tag": 4051, "value": "NEON_VFPV4" }, { "__type": "Text", "__tag": 4046, "value": " " }, { "__type": "InlineCode", "__tag": 4051, "value": "ASIMD" } ] } ] } ] }, { "__type": "TableRow", "__tag": 4068, "header": false, "children": [ { "__type": "TableCell", "__tag": 4069, "children": [ { "__type": "Paragraph", "__tag": 4045, "children": [ { "__type": "InlineCode", "__tag": 4051, "value": "ASIMDFHM" } ] } ] }, { "__type": "TableCell", "__tag": 4069, "children": [ { "__type": "Paragraph", "__tag": 4045, "children": [ { "__type": "InlineCode", "__tag": 4051, "value": "NEON" }, { "__type": "Text", "__tag": 4046, "value": " " }, { "__type": "InlineCode", "__tag": 4051, "value": "NEON_FP16" }, { "__type": "Text", "__tag": 4046, "value": " " }, { "__type": "InlineCode", "__tag": 4051, "value": "NEON_VFPV4" }, { "__type": "Text", "__tag": 4046, "value": " " }, { "__type": "InlineCode", "__tag": 4051, "value": "ASIMD" }, { "__type": "Text", "__tag": 4046, "value": " " }, { "__type": "InlineCode", "__tag": 4051, "value": "ASIMDHP" } ] } ] } ] } ] } ], "title": [ { "__type": "Text", "__tag": 4046, "value": "On ARMv7/A32" } ], "level": 2, "target": null }, { "__type": "Section", "__tag": 4015, "children": [ { "__type": "Table", "__tag": 4065, "children": [ { "__type": "TableRow", "__tag": 4068, "header": true, "children": [ { "__type": "TableCell", "__tag": 4069, "children": [ { "__type": "Paragraph", "__tag": 4045, "children": [ { "__type": "Text", "__tag": 4046, "value": "Name" } ] } ] }, { "__type": "TableCell", "__tag": 4069, "children": [ { "__type": "Paragraph", "__tag": 4045, "children": [ { "__type": "Text", "__tag": 4046, "value": "Implies" } ] } ] } ] }, { "__type": "TableRow", "__tag": 4068, "header": false, "children": [ { "__type": "TableCell", "__tag": 4069, "children": [ { "__type": "Paragraph", "__tag": 4045, "children": [ { "__type": "InlineCode", "__tag": 4051, "value": "NEON" } ] } ] }, { "__type": "TableCell", "__tag": 4069, "children": [ { "__type": "Paragraph", "__tag": 4045, "children": [ { "__type": "InlineCode", "__tag": 4051, "value": "NEON_FP16" }, { "__type": "Text", "__tag": 4046, "value": " " }, { "__type": "InlineCode", "__tag": 4051, "value": "NEON_VFPV4" }, { "__type": "Text", "__tag": 4046, "value": " " }, { "__type": "InlineCode", "__tag": 4051, "value": "ASIMD" } ] } ] } ] }, { "__type": "TableRow", "__tag": 4068, "header": false, "children": [ { "__type": "TableCell", "__tag": 4069, "children": [ { "__type": "Paragraph", "__tag": 4045, "children": [ { "__type": "InlineCode", "__tag": 4051, "value": "NEON_FP16" } ] } ] }, { "__type": "TableCell", "__tag": 4069, "children": [ { "__type": "Paragraph", "__tag": 4045, "children": [ { "__type": "InlineCode", "__tag": 4051, "value": "NEON" }, { "__type": "Text", "__tag": 4046, "value": " " }, { "__type": "InlineCode", "__tag": 4051, "value": "NEON_VFPV4" }, { "__type": "Text", "__tag": 4046, "value": " " }, { "__type": "InlineCode", "__tag": 4051, "value": "ASIMD" } ] } ] } ] }, { "__type": "TableRow", "__tag": 4068, "header": false, "children": [ { "__type": "TableCell", "__tag": 4069, "children": [ { "__type": "Paragraph", "__tag": 4045, "children": [ { "__type": "InlineCode", "__tag": 4051, "value": "NEON_VFPV4" } ] } ] }, { "__type": "TableCell", "__tag": 4069, "children": [ { "__type": "Paragraph", "__tag": 4045, "children": [ { "__type": "InlineCode", "__tag": 4051, "value": "NEON" }, { "__type": "Text", "__tag": 4046, "value": " " }, { "__type": "InlineCode", "__tag": 4051, "value": "NEON_FP16" }, { "__type": "Text", "__tag": 4046, "value": " " }, { "__type": "InlineCode", "__tag": 4051, "value": "ASIMD" } ] } ] } ] }, { "__type": "TableRow", "__tag": 4068, "header": false, "children": [ { "__type": "TableCell", "__tag": 4069, "children": [ { "__type": "Paragraph", "__tag": 4045, "children": [ { "__type": "InlineCode", "__tag": 4051, "value": "ASIMD" } ] } ] }, { "__type": "TableCell", "__tag": 4069, "children": [ { "__type": "Paragraph", "__tag": 4045, "children": [ { "__type": "InlineCode", "__tag": 4051, "value": "NEON" }, { "__type": "Text", "__tag": 4046, "value": " " }, { "__type": "InlineCode", "__tag": 4051, "value": "NEON_FP16" }, { "__type": "Text", "__tag": 4046, "value": " " }, { "__type": "InlineCode", "__tag": 4051, "value": "NEON_VFPV4" } ] } ] } ] }, { "__type": "TableRow", "__tag": 4068, "header": false, "children": [ { "__type": "TableCell", "__tag": 4069, "children": [ { "__type": "Paragraph", "__tag": 4045, "children": [ { "__type": "InlineCode", "__tag": 4051, "value": "ASIMDHP" } ] } ] }, { "__type": "TableCell", "__tag": 4069, "children": [ { "__type": "Paragraph", "__tag": 4045, "children": [ { "__type": "InlineCode", "__tag": 4051, "value": "NEON" }, { "__type": "Text", "__tag": 4046, "value": " " }, { "__type": "InlineCode", "__tag": 4051, "value": "NEON_FP16" }, { "__type": "Text", "__tag": 4046, "value": " " }, { "__type": "InlineCode", "__tag": 4051, "value": "NEON_VFPV4" }, { "__type": "Text", "__tag": 4046, "value": " " }, { "__type": "InlineCode", "__tag": 4051, "value": "ASIMD" } ] } ] } ] }, { "__type": "TableRow", "__tag": 4068, "header": false, "children": [ { "__type": "TableCell", "__tag": 4069, "children": [ { "__type": "Paragraph", "__tag": 4045, "children": [ { "__type": "InlineCode", "__tag": 4051, "value": "ASIMDDP" } ] } ] }, { "__type": "TableCell", "__tag": 4069, "children": [ { "__type": "Paragraph", "__tag": 4045, "children": [ { "__type": "InlineCode", "__tag": 4051, "value": "NEON" }, { "__type": "Text", "__tag": 4046, "value": " " }, { "__type": "InlineCode", "__tag": 4051, "value": "NEON_FP16" }, { "__type": "Text", "__tag": 4046, "value": " " }, { "__type": "InlineCode", "__tag": 4051, "value": "NEON_VFPV4" }, { "__type": "Text", "__tag": 4046, "value": " " }, { "__type": "InlineCode", "__tag": 4051, "value": "ASIMD" } ] } ] } ] }, { "__type": "TableRow", "__tag": 4068, "header": false, "children": [ { "__type": "TableCell", "__tag": 4069, "children": [ { "__type": "Paragraph", "__tag": 4045, "children": [ { "__type": "InlineCode", "__tag": 4051, "value": "ASIMDFHM" } ] } ] }, { "__type": "TableCell", "__tag": 4069, "children": [ { "__type": "Paragraph", "__tag": 4045, "children": [ { "__type": "InlineCode", "__tag": 4051, "value": "NEON" }, { "__type": "Text", "__tag": 4046, "value": " " }, { "__type": "InlineCode", "__tag": 4051, "value": "NEON_FP16" }, { "__type": "Text", "__tag": 4046, "value": " " }, { "__type": "InlineCode", "__tag": 4051, "value": "NEON_VFPV4" }, { "__type": "Text", "__tag": 4046, "value": " " }, { "__type": "InlineCode", "__tag": 4051, "value": "ASIMD" }, { "__type": "Text", "__tag": 4046, "value": " " }, { "__type": "InlineCode", "__tag": 4051, "value": "ASIMDHP" } ] } ] } ] } ] } ], "title": [ { "__type": "Text", "__tag": 4046, "value": "On ARMv8/A64" } ], "level": 2, "target": null }, { "__type": "Section", "__tag": 4015, "children": [ { "__type": "Table", "__tag": 4065, "children": [ { "__type": "TableRow", "__tag": 4068, "header": true, "children": [ { "__type": "TableCell", "__tag": 4069, "children": [ { "__type": "Paragraph", "__tag": 4045, "children": [ { "__type": "Text", "__tag": 4046, "value": "Name" } ] } ] }, { "__type": "TableCell", "__tag": 4069, "children": [ { "__type": "Paragraph", "__tag": 4045, "children": [ { "__type": "Text", "__tag": 4046, "value": "Implies" } ] } ] } ] }, { "__type": "TableRow", "__tag": 4068, "header": false, "children": [ { "__type": "TableCell", "__tag": 4069, "children": [ { "__type": "Paragraph", "__tag": 4045, "children": [ { "__type": "InlineCode", "__tag": 4051, "value": "VX" } ] } ] }, { "__type": "TableCell", "__tag": 4069, "children": [] } ] }, { "__type": "TableRow", "__tag": 4068, "header": false, "children": [ { "__type": "TableCell", "__tag": 4069, "children": [ { "__type": "Paragraph", "__tag": 4045, "children": [ { "__type": "InlineCode", "__tag": 4051, "value": "VXE" } ] } ] }, { "__type": "TableCell", "__tag": 4069, "children": [ { "__type": "Paragraph", "__tag": 4045, "children": [ { "__type": "InlineCode", "__tag": 4051, "value": "VX" } ] } ] } ] }, { "__type": "TableRow", "__tag": 4068, "header": false, "children": [ { "__type": "TableCell", "__tag": 4069, "children": [ { "__type": "Paragraph", "__tag": 4045, "children": [ { "__type": "InlineCode", "__tag": 4051, "value": "VXE2" } ] } ] }, { "__type": "TableCell", "__tag": 4069, "children": [ { "__type": "Paragraph", "__tag": 4045, "children": [ { "__type": "InlineCode", "__tag": 4051, "value": "VX" }, { "__type": "Text", "__tag": 4046, "value": " " }, { "__type": "InlineCode", "__tag": 4051, "value": "VXE" } ] } ] } ] } ] } ], "title": [ { "__type": "Text", "__tag": 4046, "value": "On IBM/ZSYSTEM(S390X)" } ], "level": 2, "target": null }, { "__type": "Section", "__tag": 4015, "children": [ { "__type": "Table", "__tag": 4065, "children": [ { "__type": "TableRow", "__tag": 4068, "header": true, "children": [ { "__type": "TableCell", "__tag": 4069, "children": [ { "__type": "Paragraph", "__tag": 4045, "children": [ { "__type": "Text", "__tag": 4046, "value": "Name" } ] } ] }, { "__type": "TableCell", "__tag": 4069, "children": [ { "__type": "Paragraph", "__tag": 4045, "children": [ { "__type": "Text", "__tag": 4046, "value": "Implies" } ] } ] } ] }, { "__type": "TableRow", "__tag": 4068, "header": false, "children": [ { "__type": "TableCell", "__tag": 4069, "children": [ { "__type": "Paragraph", "__tag": 4045, "children": [ { "__type": "InlineCode", "__tag": 4051, "value": "RVV" } ] } ] }, { "__type": "TableCell", "__tag": 4069, "children": [] } ] } ] } ], "title": [ { "__type": "Text", "__tag": 4046, "value": "On RISCV64" } ], "level": 2, "target": null }, { "__type": "Section", "__tag": 4015, "children": [ { "__type": "Paragraph", "__tag": 4045, "children": [ { "__type": "Text", "__tag": 4046, "value": "Beyond specific feature names, you can use these special values:" } ] } ], "title": [ { "__type": "Text", "__tag": 4046, "value": "Special Options" } ], "level": 1, "target": "opt-special-options" }, { "__type": "Section", "__tag": 4015, "children": [ { "__type": "Paragraph", "__tag": 4045, "children": [ { "__type": "Text", "__tag": 4046, "value": "Enables no features (equivalent to an empty string)." } ] } ], "title": [ { "__type": "InlineCode", "__tag": 4051, "value": "NONE" } ], "level": 2, "target": null }, { "__type": "Section", "__tag": 4015, "children": [ { "__type": "Paragraph", "__tag": 4045, "children": [ { "__type": "Text", "__tag": 4046, "value": "Enables all features supported by the host CPU." } ] } ], "title": [ { "__type": "InlineCode", "__tag": 4051, "value": "NATIVE" } ], "level": 2, "target": null }, { "__type": "Section", "__tag": 4015, "children": [ { "__type": "Paragraph", "__tag": 4045, "children": [ { "__type": "Text", "__tag": 4046, "value": "Detects the features enabled by the compiler. This option is appended by default to " }, { "__type": "InlineCode", "__tag": 4051, "value": "cpu-baseline" }, { "__type": "Text", "__tag": 4046, "value": " if " }, { "__type": "InlineCode", "__tag": 4051, "value": "-march" }, { "__type": "Text", "__tag": 4046, "value": ", " }, { "__type": "InlineCode", "__tag": 4051, "value": "-mcpu" }, { "__type": "Text", "__tag": 4046, "value": ", " }, { "__type": "InlineCode", "__tag": 4051, "value": "-xhost" }, { "__type": "Text", "__tag": 4046, "value": ", or " }, { "__type": "InlineCode", "__tag": 4051, "value": "/QxHost" }, { "__type": "Text", "__tag": 4046, "value": " is set in the environment variable " }, { "__type": "InlineCode", "__tag": 4051, "value": "CFLAGS" }, { "__type": "Text", "__tag": 4046, "value": " unless " }, { "__type": "InlineCode", "__tag": 4051, "value": "cpu-baseline-detect" }, { "__type": "Text", "__tag": 4046, "value": " is " }, { "__type": "InlineCode", "__tag": 4051, "value": "disabled" }, { "__type": "Text", "__tag": 4046, "value": "." } ] } ], "title": [ { "__type": "InlineCode", "__tag": 4051, "value": "DETECT" } ], "level": 2, "target": null }, { "__type": "Section", "__tag": 4015, "children": [ { "__type": "Paragraph", "__tag": 4045, "children": [ { "__type": "Text", "__tag": 4046, "value": "Enables the minimum CPU features for each architecture:" } ] }, { "__type": "Table", "__tag": 4065, "children": [ { "__type": "TableRow", "__tag": 4068, "header": true, "children": [ { "__type": "TableCell", "__tag": 4069, "children": [ { "__type": "Paragraph", "__tag": 4045, "children": [ { "__type": "Text", "__tag": 4046, "value": "For Arch" } ] } ] }, { "__type": "TableCell", "__tag": 4069, "children": [ { "__type": "Paragraph", "__tag": 4045, "children": [ { "__type": "Text", "__tag": 4046, "value": "Implies" } ] } ] } ] }, { "__type": "TableRow", "__tag": 4068, "header": false, "children": [ { "__type": "TableCell", "__tag": 4069, "children": [ { "__type": "Paragraph", "__tag": 4045, "children": [ { "__type": "Text", "__tag": 4046, "value": "x86 (32-bit)" } ] } ] }, { "__type": "TableCell", "__tag": 4069, "children": [ { "__type": "Paragraph", "__tag": 4045, "children": [ { "__type": "InlineCode", "__tag": 4051, "value": "X86_V2" } ] } ] } ] }, { "__type": "TableRow", "__tag": 4068, "header": false, "children": [ { "__type": "TableCell", "__tag": 4069, "children": [ { "__type": "Paragraph", "__tag": 4045, "children": [ { "__type": "Text", "__tag": 4046, "value": "x86-64" } ] } ] }, { "__type": "TableCell", "__tag": 4069, "children": [ { "__type": "Paragraph", "__tag": 4045, "children": [ { "__type": "InlineCode", "__tag": 4051, "value": "X86_V2" } ] } ] } ] }, { "__type": "TableRow", "__tag": 4068, "header": false, "children": [ { "__type": "TableCell", "__tag": 4069, "children": [ { "__type": "Paragraph", "__tag": 4045, "children": [ { "__type": "Text", "__tag": 4046, "value": "IBM/POWER (big-endian)" } ] } ] }, { "__type": "TableCell", "__tag": 4069, "children": [ { "__type": "Paragraph", "__tag": 4045, "children": [ { "__type": "InlineCode", "__tag": 4051, "value": "NONE" } ] } ] } ] }, { "__type": "TableRow", "__tag": 4068, "header": false, "children": [ { "__type": "TableCell", "__tag": 4069, "children": [ { "__type": "Paragraph", "__tag": 4045, "children": [ { "__type": "Text", "__tag": 4046, "value": "IBM/POWER (little-endian)" } ] } ] }, { "__type": "TableCell", "__tag": 4069, "children": [ { "__type": "Paragraph", "__tag": 4045, "children": [ { "__type": "InlineCode", "__tag": 4051, "value": "VSX" }, { "__type": "Text", "__tag": 4046, "value": " " }, { "__type": "InlineCode", "__tag": 4051, "value": "VSX2" } ] } ] } ] }, { "__type": "TableRow", "__tag": 4068, "header": false, "children": [ { "__type": "TableCell", "__tag": 4069, "children": [ { "__type": "Paragraph", "__tag": 4045, "children": [ { "__type": "Text", "__tag": 4046, "value": "ARMv7/ARMHF" } ] } ] }, { "__type": "TableCell", "__tag": 4069, "children": [ { "__type": "Paragraph", "__tag": 4045, "children": [ { "__type": "InlineCode", "__tag": 4051, "value": "NONE" } ] } ] } ] }, { "__type": "TableRow", "__tag": 4068, "header": false, "children": [ { "__type": "TableCell", "__tag": 4069, "children": [ { "__type": "Paragraph", "__tag": 4045, "children": [ { "__type": "Text", "__tag": 4046, "value": "ARMv8/AArch64" } ] } ] }, { "__type": "TableCell", "__tag": 4069, "children": [ { "__type": "Paragraph", "__tag": 4045, "children": [ { "__type": "InlineCode", "__tag": 4051, "value": "NEON" }, { "__type": "Text", "__tag": 4046, "value": " " }, { "__type": "InlineCode", "__tag": 4051, "value": "NEON_FP16" }, { "__type": "Text", "__tag": 4046, "value": " " }, { "__type": "InlineCode", "__tag": 4051, "value": "NEON_VFPV4" }, { "__type": "Text", "__tag": 4046, "value": " " }, { "__type": "InlineCode", "__tag": 4051, "value": "ASIMD" } ] } ] } ] }, { "__type": "TableRow", "__tag": 4068, "header": false, "children": [ { "__type": "TableCell", "__tag": 4069, "children": [ { "__type": "Paragraph", "__tag": 4045, "children": [ { "__type": "Text", "__tag": 4046, "value": "IBM/ZSYSTEM(S390X)" } ] } ] }, { "__type": "TableCell", "__tag": 4069, "children": [ { "__type": "Paragraph", "__tag": 4045, "children": [ { "__type": "InlineCode", "__tag": 4051, "value": "NONE" } ] } ] } ] }, { "__type": "TableRow", "__tag": 4068, "header": false, "children": [ { "__type": "TableCell", "__tag": 4069, "children": [ { "__type": "Paragraph", "__tag": 4045, "children": [ { "__type": "Text", "__tag": 4046, "value": "riscv64" } ] } ] }, { "__type": "TableCell", "__tag": 4069, "children": [ { "__type": "Paragraph", "__tag": 4045, "children": [ { "__type": "InlineCode", "__tag": 4051, "value": "NONE" } ] } ] } ] } ] } ], "title": [ { "__type": "InlineCode", "__tag": 4051, "value": "MIN" } ], "level": 2, "target": null }, { "__type": "Section", "__tag": 4015, "children": [ { "__type": "Paragraph", "__tag": 4045, "children": [ { "__type": "Text", "__tag": 4046, "value": "Enables all features supported by the compiler and platform." } ] } ], "title": [ { "__type": "InlineCode", "__tag": 4051, "value": "MAX" } ], "level": 2, "target": null }, { "__type": "Section", "__tag": 4015, "children": [ { "__type": "Paragraph", "__tag": 4045, "children": [ { "__type": "Text", "__tag": 4046, "value": "Remove or add specific features, useful with " }, { "__type": "InlineCode", "__tag": 4051, "value": "MAX" }, { "__type": "Text", "__tag": 4046, "value": ", " }, { "__type": "InlineCode", "__tag": 4051, "value": "MIN" }, { "__type": "Text", "__tag": 4046, "value": ", and " }, { "__type": "InlineCode", "__tag": 4051, "value": "NATIVE" }, { "__type": "Text", "__tag": 4046, "value": ":" } ] }, { "__type": "BulletList", "__tag": 4053, "ordered": false, "start": 1, "children": [ { "__type": "ListItem", "__tag": 4054, "children": [ { "__type": "Paragraph", "__tag": 4045, "children": [ { "__type": "Text", "__tag": 4046, "value": "Adding a feature (" }, { "__type": "InlineCode", "__tag": 4051, "value": "+" }, { "__type": "Text", "__tag": 4046, "value": ") includes all implied features" } ] } ] }, { "__type": "ListItem", "__tag": 4054, "children": [ { "__type": "Paragraph", "__tag": 4045, "children": [ { "__type": "Text", "__tag": 4046, "value": "Removing a feature (" }, { "__type": "InlineCode", "__tag": 4051, "value": "-" }, { "__type": "Text", "__tag": 4046, "value": ") excludes all successor features that imply the removed feature" } ] } ] } ] }, { "__type": "Paragraph", "__tag": 4045, "children": [ { "__type": "Text", "__tag": 4046, "value": "Examples " } ] }, { "__type": "Code", "__tag": 4050, "value": "python -m build --wheel -Csetup-args=-Dcpu-dispatch=\"max-X86_V4\"\npython -m build --wheel -Csetup-args=-Dcpu-baseline=\"min+X86_V4\"", "execution_status": null } ], "title": [ { "__type": "Text", "__tag": 4046, "value": "Operator Operators (" }, { "__type": "InlineCode", "__tag": 4051, "value": "-" }, { "__type": "Text", "__tag": 4046, "value": "/" }, { "__type": "InlineCode", "__tag": 4051, "value": "+" }, { "__type": "Text", "__tag": 4046, "value": ")" } ], "level": 2, "target": null }, { "__type": "Section", "__tag": 4015, "children": [], "title": [ { "__type": "Text", "__tag": 4046, "value": "Usage And Behaviors" } ], "level": 1, "target": null }, { "__type": "Section", "__tag": 4015, "children": [ { "__type": "Paragraph", "__tag": 4045, "children": [ { "__type": "Text", "__tag": 4046, "value": "CPU features and options are case-insensitive " } ] }, { "__type": "Code", "__tag": 4050, "value": "python -m build --wheel -Csetup-args=-Dcpu-dispatch=\"X86_v4\"", "execution_status": null } ], "title": [ { "__type": "Text", "__tag": 4046, "value": "Case Insensitivity" } ], "level": 2, "target": null }, { "__type": "Section", "__tag": 4015, "children": [ { "__type": "Paragraph", "__tag": 4045, "children": [ { "__type": "Text", "__tag": 4046, "value": "You can mix features from different architectures " } ] }, { "__type": "Code", "__tag": 4050, "value": "python -m build --wheel -Csetup-args=-Dcpu-baseline=\"X86_V4 VSX4 SVE\"", "execution_status": null } ], "title": [ { "__type": "Text", "__tag": 4046, "value": "Mixing Features across Architectures" } ], "level": 2, "target": null }, { "__type": "Section", "__tag": 4015, "children": [ { "__type": "Paragraph", "__tag": 4045, "children": [ { "__type": "Text", "__tag": 4046, "value": "The order of specified features doesn't matter " } ] }, { "__type": "Code", "__tag": 4050, "value": "python -m build --wheel -Csetup-args=-Dcpu-dispatch=\"SVE X86_V4 x86_v3\"", "execution_status": null } ], "title": [ { "__type": "Text", "__tag": 4046, "value": "Order Independence" } ], "level": 2, "target": null }, { "__type": "Section", "__tag": 4015, "children": [ { "__type": "Paragraph", "__tag": 4045, "children": [ { "__type": "Text", "__tag": 4046, "value": "You can use spaces or commas as separators " } ] }, { "__type": "Code", "__tag": 4050, "value": "# All of these are equivalent\npython -m build --wheel -Csetup-args=-Dcpu-dispatch=\"X86_V2 X86_V4\"\npython -m build --wheel -Csetup-args=-Dcpu-dispatch=X86_V2,X86_V4", "execution_status": null } ], "title": [ { "__type": "Text", "__tag": 4046, "value": "Separators" } ], "level": 2, "target": null }, { "__type": "Section", "__tag": 4015, "children": [ { "__type": "Paragraph", "__tag": 4045, "children": [ { "__type": "Text", "__tag": 4046, "value": "Features specified in options are automatically combined with all implied features " } ] }, { "__type": "Code", "__tag": 4050, "value": "python -m build --wheel -Csetup-args=-Dcpu-baseline=X86_V4", "execution_status": null }, { "__type": "Paragraph", "__tag": 4045, "children": [ { "__type": "Text", "__tag": 4046, "value": "Equivalent to " } ] }, { "__type": "Code", "__tag": 4050, "value": "python -m build --wheel -Csetup-args=-Dcpu-baseline=\"X86_V2 X86_V3 X86_V4\"", "execution_status": null } ], "title": [ { "__type": "Text", "__tag": 4046, "value": "Feature Combination" } ], "level": 2, "target": null }, { "__type": "Section", "__tag": 4015, "children": [ { "__type": "Paragraph", "__tag": 4045, "children": [ { "__type": "Text", "__tag": 4046, "value": "Features specified in " }, { "__type": "InlineCode", "__tag": 4051, "value": "cpu-baseline" }, { "__type": "Text", "__tag": 4046, "value": " will be excluded from the " }, { "__type": "InlineCode", "__tag": 4051, "value": "cpu-dispatch" }, { "__type": "Text", "__tag": 4046, "value": " features, along with their implied features, but without excluding successor features that imply them." } ] }, { "__type": "Paragraph", "__tag": 4045, "children": [ { "__type": "Text", "__tag": 4046, "value": "For instance, if you specify " }, { "__type": "InlineCode", "__tag": 4051, "value": "cpu-baseline=\"X86_V4\"" }, { "__type": "Text", "__tag": 4046, "value": ", it will exclude " }, { "__type": "InlineCode", "__tag": 4051, "value": "X86_V4" }, { "__type": "Text", "__tag": 4046, "value": " and its implied features " }, { "__type": "InlineCode", "__tag": 4051, "value": "X86_V2" }, { "__type": "Text", "__tag": 4046, "value": " and " }, { "__type": "InlineCode", "__tag": 4051, "value": "X86_V3" }, { "__type": "Text", "__tag": 4046, "value": " from the " }, { "__type": "InlineCode", "__tag": 4051, "value": "cpu-dispatch" }, { "__type": "Text", "__tag": 4046, "value": " features." } ] } ], "title": [ { "__type": "Text", "__tag": 4046, "value": "Baseline Overlapping" } ], "level": 2, "target": null }, { "__type": "Section", "__tag": 4015, "children": [ { "__type": "Paragraph", "__tag": 4045, "children": [ { "__type": "Text", "__tag": 4046, "value": "Specifying features to " }, { "__type": "InlineCode", "__tag": 4051, "value": "cpu-dispatch" }, { "__type": "Text", "__tag": 4046, "value": " or " }, { "__type": "InlineCode", "__tag": 4051, "value": "cpu-baseline" }, { "__type": "Text", "__tag": 4046, "value": " doesn't explicitly enable them. Features are detected at compile time, and the maximum available features based on your specified options will be enabled according to toolchain and platform support." } ] }, { "__type": "Paragraph", "__tag": 4045, "children": [ { "__type": "Text", "__tag": 4046, "value": "This detection occurs by testing feature availability in the compiler through compile-time source files containing common intrinsics for the specified features. If both the compiler and assembler support the feature, it will be enabled." } ] }, { "__type": "Paragraph", "__tag": 4045, "children": [ { "__type": "Text", "__tag": 4046, "value": "For example, if you specify " }, { "__type": "InlineCode", "__tag": 4051, "value": "cpu-dispatch=\"AVX512_ICL\"" }, { "__type": "Text", "__tag": 4046, "value": " but your compiler doesn't support it, the feature will be excluded from the build. However, any implied features will still be enabled if they're supported." } ] } ], "title": [ { "__type": "Text", "__tag": 4046, "value": "Compile-time Detection" } ], "level": 2, "target": null }, { "__type": "Section", "__tag": 4015, "children": [ { "__type": "Paragraph", "__tag": 4045, "children": [ { "__type": "Text", "__tag": 4046, "value": "Some exceptional conditions force us to link some features together when it come to certain compilers or architectures, resulting in the impossibility of building them separately." } ] }, { "__type": "Paragraph", "__tag": 4045, "children": [ { "__type": "Text", "__tag": 4046, "value": "These conditions can be divided into two parts, as follows:" } ] }, { "__type": "Paragraph", "__tag": 4045, "children": [ { "__type": "Strong", "__tag": 4048, "children": [ { "__type": "Text", "__tag": 4046, "value": "Architectural compatibility" } ] } ] }, { "__type": "Paragraph", "__tag": 4045, "children": [ { "__type": "Text", "__tag": 4046, "value": "The need to align certain CPU features that are assured to be supported by successive generations of the same architecture, some cases:" } ] }, { "__type": "BulletList", "__tag": 4053, "ordered": false, "start": 1, "children": [ { "__type": "ListItem", "__tag": 4054, "children": [ { "__type": "Paragraph", "__tag": 4045, "children": [ { "__type": "Text", "__tag": 4046, "value": "On ppc64le " }, { "__type": "InlineCode", "__tag": 4051, "value": "VSX(ISA 2.06)" }, { "__type": "Text", "__tag": 4046, "value": " and " }, { "__type": "InlineCode", "__tag": 4051, "value": "VSX2(ISA 2.07)" }, { "__type": "Text", "__tag": 4046, "value": " both imply one another since the first generation that supports little-endian mode is " }, { "__type": "InlineCode", "__tag": 4051, "value": "Power-8(ISA 2.07)" } ] } ] }, { "__type": "ListItem", "__tag": 4054, "children": [ { "__type": "Paragraph", "__tag": 4045, "children": [ { "__type": "Text", "__tag": 4046, "value": "On AArch64 " }, { "__type": "InlineCode", "__tag": 4051, "value": "NEON NEON_FP16 NEON_VFPV4 ASIMD" }, { "__type": "Text", "__tag": 4046, "value": " implies each other since they are part of the hardware baseline." } ] } ] } ] }, { "__type": "Paragraph", "__tag": 4045, "children": [ { "__type": "Text", "__tag": 4046, "value": "For example " } ] }, { "__type": "Code", "__tag": 4050, "value": "# On ARMv8/A64, specify NEON is going to enable Advanced SIMD\n# and all predecessor extensions\npython -m build --wheel -Csetup-args=-Dcpu-baseline=neon\n# which is equivalent to\npython -m build --wheel -Csetup-args=-Dcpu-baseline=\"neon neon_fp16 neon_vfpv4 asimd\"", "execution_status": null }, { "__type": "Admonition", "__tag": 4056, "kind": "note", "base_type": "note", "children": [ { "__type": "AdmonitionTitle", "__tag": 4055, "children": [ { "__type": "Text", "__tag": 4046, "value": "note " } ] }, { "__type": "Paragraph", "__tag": 4045, "children": [ { "__type": "Text", "__tag": 4046, "value": "Please take a deep look at " }, { "__type": "CrossRef", "__tag": 4002, "value": "opt-supported-features", "reference": { "__type": "LocalRef", "__tag": 4022, "kind": "docs", "path": "reference:simd:build-options" }, "kind": "exists" }, { "__type": "Text", "__tag": 4046, "value": ", in order to determine the features that imply one another." } ] } ] } ], "title": [ { "__type": "Text", "__tag": 4046, "value": "Platform differences" } ], "level": 1, "target": "opt-platform-differences" }, { "__type": "Section", "__tag": 4015, "children": [ { "__type": "Paragraph", "__tag": 4045, "children": [ { "__type": "Text", "__tag": 4046, "value": "In most cases, the CPU build options do not produce any fatal errors that lead to hanging the build. Most of the errors that may appear in the build log serve as heavy warnings due to the lack of some expected CPU features by the compiler." } ] }, { "__type": "Paragraph", "__tag": 4045, "children": [ { "__type": "Text", "__tag": 4046, "value": "So we strongly recommend checking the final report log, to be aware of what kind of CPU features are enabled and what are not." } ] }, { "__type": "Paragraph", "__tag": 4045, "children": [ { "__type": "Text", "__tag": 4046, "value": "You can find the final report of CPU optimizations by tracing meson build log, and here is how it looks on x86_64/gcc:" } ] } ], "title": [ { "__type": "Text", "__tag": 4046, "value": "Build report" } ], "level": 1, "target": "opt-build-report" }, { "__type": "Section", "__tag": 4015, "children": [ { "__type": "Paragraph", "__tag": 4045, "children": [ { "__type": "Text", "__tag": 4046, "value": "Importing NumPy triggers a scan of the available CPU features from the set of dispatchable features. You can restrict this scan by setting the environment variable " }, { "__type": "InlineCode", "__tag": 4051, "value": "NPY_DISABLE_CPU_FEATURES" }, { "__type": "Text", "__tag": 4046, "value": " to a comma-, tab-, or space-separated list of features to disable." } ] }, { "__type": "Paragraph", "__tag": 4045, "children": [ { "__type": "Text", "__tag": 4046, "value": "For instance, on " }, { "__type": "InlineCode", "__tag": 4051, "value": "x86_64" }, { "__type": "Text", "__tag": 4046, "value": " this will disable " }, { "__type": "InlineCode", "__tag": 4051, "value": "X86_V4" }, { "__type": "Text", "__tag": 4046, "value": " " } ] }, { "__type": "Code", "__tag": 4050, "value": "NPY_DISABLE_CPU_FEATURES=\"X86_V4\"", "execution_status": null }, { "__type": "Paragraph", "__tag": 4045, "children": [ { "__type": "Text", "__tag": 4046, "value": "This will raise an error if parsing fails or if the feature was not enabled through the " }, { "__type": "InlineCode", "__tag": 4051, "value": "cpu-dispatch" }, { "__type": "Text", "__tag": 4046, "value": " build option. If the feature is supported by the build but not available on the current CPU, a warning will be emitted instead." } ] } ], "title": [ { "__type": "Text", "__tag": 4046, "value": "Runtime Dispatch" } ], "level": 1, "target": "runtime-simd-dispatch" }, { "__type": "Section", "__tag": 4015, "children": [ { "__type": "Paragraph", "__tag": 4045, "children": [ { "__type": "Text", "__tag": 4046, "value": "You can discover which CPU targets are enabled for different optimized functions using the Python function " }, { "__type": "InlineCode", "__tag": 4051, "value": "numpy.lib.introspect.opt_func_info" }, { "__type": "Text", "__tag": 4046, "value": "." } ] }, { "__type": "Paragraph", "__tag": 4045, "children": [ { "__type": "Text", "__tag": 4046, "value": "This function offers two optional arguments for filtering results:" } ] }, { "__type": "BulletList", "__tag": 4053, "ordered": true, "start": 1, "children": [ { "__type": "ListItem", "__tag": 4054, "children": [ { "__type": "Paragraph", "__tag": 4045, "children": [ { "__type": "InlineCode", "__tag": 4051, "value": "func_name" }, { "__type": "Text", "__tag": 4046, "value": " - For refining function names" } ] } ] }, { "__type": "ListItem", "__tag": 4054, "children": [ { "__type": "Paragraph", "__tag": 4045, "children": [ { "__type": "InlineCode", "__tag": 4051, "value": "signature" }, { "__type": "Text", "__tag": 4046, "value": " - For specifying data types in the signatures" } ] } ] } ] }, { "__type": "Paragraph", "__tag": 4045, "children": [ { "__type": "Text", "__tag": 4046, "value": "For example " } ] }, { "__type": "Code", "__tag": 4050, "value": " >> func_info = numpy.lib.introspect.opt_func_info(func_name='add|abs', signature='float64|complex64')\n >> print(json.dumps(func_info, indent=2))\n {\n \"absolute\": {\n \"dd\": {\n \"current\": \"baseline(X86_V2)\",\n \"available\": \"baseline(X86_V2)\"\n },\n \"Ff\": {\n \"current\": \"X86_V3\",\n \"available\": \"X86_V3 baseline(X86_V2)\"\n },\n \"Dd\": {\n \"current\": \"X86_V3\",\n \"available\": \"X86_V3 baseline(X86_V2)\"\n }\n },\n \"add\": {\n \"ddd\": {\n \"current\": \"X86_V3\",\n \"available\": \"X86_V3 baseline(X86_V2)\"\n },\n \"FFF\": {\n \"current\": \"X86_V3\",\n \"available\": \"X86_V3 baseline(X86_V2)\"\n }\n }\n}", "execution_status": null } ], "title": [ { "__type": "Text", "__tag": 4046, "value": "Tracking Dispatched Functions" } ], "level": 1, "target": null } ], "local_refs": [] }