{ "__type": "IngestedDoc", "__tag": 4010, "_content": { "Notes": { "__type": "Section", "__tag": 4015, "children": [ { "__type": "Paragraph", "__tag": 4045, "children": [ { "__type": "CrossRef", "__tag": 4002, "value": "SFC64", "reference": { "__type": "LocalRef", "__tag": 4022, "kind": "module", "path": "numpy.random._sfc64:SFC64" }, "kind": "module" }, { "__type": "Text", "__tag": 4046, "value": " is a 256-bit implementation of Chris Doty-Humphrey's Small Fast Chaotic PRNG (" }, { "__type": "FootnoteReference", "__tag": 4066, "label": "1" }, { "__type": "Text", "__tag": 4046, "value": "). " }, { "__type": "CrossRef", "__tag": 4002, "value": "SFC64", "reference": { "__type": "LocalRef", "__tag": 4022, "kind": "module", "path": "numpy.random._sfc64:SFC64" }, "kind": "module" }, { "__type": "Text", "__tag": 4046, "value": " has a few different cycles that one might be on, depending on the seed; the expected period will be about " }, { "__type": "InlineMath", "__tag": 4057, "value": "2^{255}" }, { "__type": "Text", "__tag": 4046, "value": " (" }, { "__type": "FootnoteReference", "__tag": 4066, "label": "2" }, { "__type": "Text", "__tag": 4046, "value": "). " }, { "__type": "CrossRef", "__tag": 4002, "value": "SFC64", "reference": { "__type": "LocalRef", "__tag": 4022, "kind": "module", "path": "numpy.random._sfc64:SFC64" }, "kind": "module" }, { "__type": "Text", "__tag": 4046, "value": " incorporates a 64-bit counter which means that the absolute minimum cycle length is " }, { "__type": "InlineMath", "__tag": 4057, "value": "2^{64}" }, { "__type": "Text", "__tag": 4046, "value": " and that distinct seeds will not run into each other for at least " }, { "__type": "InlineMath", "__tag": 4057, "value": "2^{64}" }, { "__type": "Text", "__tag": 4046, "value": " iterations." } ] }, { "__type": "Paragraph", "__tag": 4045, "children": [ { "__type": "CrossRef", "__tag": 4002, "value": "SFC64", "reference": { "__type": "LocalRef", "__tag": 4022, "kind": "module", "path": "numpy.random._sfc64:SFC64" }, "kind": "module" }, { "__type": "Text", "__tag": 4046, "value": " provides a capsule containing function pointers that produce doubles, and unsigned 32 and 64- bit integers. These are not directly consumable in Python and must be consumed by a " }, { "__type": "CrossRef", "__tag": 4002, "value": "Generator", "reference": { "__type": "LocalRef", "__tag": 4022, "kind": "module", "path": "numpy.random._generator:Generator" }, "kind": "module" }, { "__type": "Text", "__tag": 4046, "value": " or similar object that supports low-level access." } ] }, { "__type": "Paragraph", "__tag": 4045, "children": [ { "__type": "Strong", "__tag": 4048, "children": [ { "__type": "Text", "__tag": 4046, "value": "State and Seeding" } ] } ] }, { "__type": "Paragraph", "__tag": 4045, "children": [ { "__type": "Text", "__tag": 4046, "value": "The " }, { "__type": "CrossRef", "__tag": 4002, "value": "SFC64", "reference": { "__type": "LocalRef", "__tag": 4022, "kind": "module", "path": "numpy.random._sfc64:SFC64" }, "kind": "module" }, { "__type": "Text", "__tag": 4046, "value": " state vector consists of 4 unsigned 64-bit values. The last is a 64-bit counter that increments by 1 each iteration." } ] }, { "__type": "Paragraph", "__tag": 4045, "children": [ { "__type": "Text", "__tag": 4046, "value": "The input seed is processed by " }, { "__type": "CrossRef", "__tag": 4002, "value": "SeedSequence", "reference": { "__type": "LocalRef", "__tag": 4022, "kind": "module", "path": "numpy.random.bit_generator:SeedSequence" }, "kind": "module" }, { "__type": "Text", "__tag": 4046, "value": " to generate the first 3 values, then the " }, { "__type": "CrossRef", "__tag": 4002, "value": "SFC64", "reference": { "__type": "LocalRef", "__tag": 4022, "kind": "module", "path": "numpy.random._sfc64:SFC64" }, "kind": "module" }, { "__type": "Text", "__tag": 4046, "value": " algorithm is iterated a small number of times to mix." } ] }, { "__type": "Paragraph", "__tag": 4045, "children": [ { "__type": "Strong", "__tag": 4048, "children": [ { "__type": "Text", "__tag": 4046, "value": "Compatibility Guarantee" } ] } ] }, { "__type": "Paragraph", "__tag": 4045, "children": [ { "__type": "CrossRef", "__tag": 4002, "value": "SFC64", "reference": { "__type": "LocalRef", "__tag": 4022, "kind": "module", "path": "numpy.random._sfc64:SFC64" }, "kind": "module" }, { "__type": "Text", "__tag": 4046, "value": " makes a guarantee that a fixed seed will always produce the same random integer stream." } ] } ], "title": [], "level": 0, "target": null }, "Warns": { "__type": "Section", "__tag": 4015, "children": [], "title": [], "level": 0, "target": null }, "Raises": { "__type": "Section", "__tag": 4015, "children": [], "title": [], "level": 0, "target": null }, "Yields": { "__type": "Section", "__tag": 4015, "children": [], "title": [], "level": 0, "target": null }, "Methods": { "__type": "Section", "__tag": 4015, "children": [], "title": [], "level": 0, "target": null }, "Returns": { "__type": "Section", "__tag": 4015, "children": [], "title": [], "level": 0, "target": null }, "Summary": { "__type": "Section", "__tag": 4015, "children": [ { "__type": "Paragraph", "__tag": 4045, "children": [ { "__type": "Text", "__tag": 4046, "value": "BitGenerator for Chris Doty-Humphrey's Small Fast Chaotic PRNG." } ] } ], "title": [], "level": 0, "target": null }, "Receives": { "__type": "Section", "__tag": 4015, "children": [], "title": [], "level": 0, "target": null }, "Warnings": { "__type": "Section", "__tag": 4015, "children": [], "title": [], "level": 0, "target": null }, "Attributes": { "__type": "Section", "__tag": 4015, "children": [], "title": [], "level": 0, "target": null }, "Parameters": { "__type": "Section", "__tag": 4015, "children": [ { "__type": "Parameters", "__tag": 4026, "children": [ { "__type": "DocParam", "__tag": 4016, "name": "seed", "annotation": "{None, int, array_like[ints], SeedSequence}, optional", "desc": [ { "__type": "Paragraph", "__tag": 4045, "children": [ { "__type": "Text", "__tag": 4046, "value": "A seed to initialize the " }, { "__type": "CrossRef", "__tag": 4002, "value": "BitGenerator", "reference": { "__type": "LocalRef", "__tag": 4022, "kind": "module", "path": "numpy.random.bit_generator:BitGenerator" }, "kind": "module" }, { "__type": "Text", "__tag": 4046, "value": ". If None, then fresh, unpredictable entropy will be pulled from the OS. If an " }, { "__type": "InlineCode", "__tag": 4051, "value": "int" }, { "__type": "Text", "__tag": 4046, "value": " or " }, { "__type": "InlineCode", "__tag": 4051, "value": "array_like[ints]" }, { "__type": "Text", "__tag": 4046, "value": " is passed, then it will be passed to " }, { "__type": "CrossRef", "__tag": 4002, "value": "SeedSequence", "reference": { "__type": "LocalRef", "__tag": 4022, "kind": "module", "path": "numpy.random.bit_generator:SeedSequence" }, "kind": "module" }, { "__type": "Text", "__tag": 4046, "value": " to derive the initial " }, { "__type": "CrossRef", "__tag": 4002, "value": "BitGenerator", "reference": { "__type": "LocalRef", "__tag": 4022, "kind": "module", "path": "numpy.random.bit_generator:BitGenerator" }, "kind": "module" }, { "__type": "Text", "__tag": 4046, "value": " state. One may also pass in a " }, { "__type": "CrossRef", "__tag": 4002, "value": "SeedSequence", "reference": { "__type": "LocalRef", "__tag": 4022, "kind": "module", "path": "numpy.random.bit_generator:SeedSequence" }, "kind": "module" }, { "__type": "Text", "__tag": 4046, "value": " instance." } ] } ] } ] } ], "title": [], "level": 0, "target": null }, "Extended Summary": { "__type": "Section", "__tag": 4015, "children": [], "title": [], "level": 0, "target": null }, "Other Parameters": { "__type": "Section", "__tag": 4015, "children": [], "title": [], "level": 0, "target": null } }, "_ordered_sections": [ "Summary", "Extended Summary", "Parameters", "Attributes", "Methods", "Returns", "Yields", "Receives", "Other Parameters", "Raises", "Warns", "Warnings", "Notes" ], "item_file": "/numpy/random/_sfc64.cpython-314-x86_64-linux-gnu.so", "item_line": null, "item_type": "class", "aliases": [ "numpy.random.SFC64" ], "example_section_data": { "__type": "Section", "__tag": 4015, "children": [], "title": [], "level": 0, "target": null }, "see_also": [], "signature": { "__type": "SignatureNode", "__tag": 4029, "kind": "function", "parameters": [ { "__type": "SigParam", "__tag": 4030, "name": "seed", "annotation": { "__type": "Empty", "__tag": 4031 }, "kind": "POSITIONAL_OR_KEYWORD", "default": "None" } ], "return_annotation": { "__type": "Empty", "__tag": 4031 }, "target_name": "SFC64" }, "references": [ ".. [1] `\"PractRand\"", " `_", ".. [2] `\"Random Invertible Mapping Statistics\"", " `_" ], "qa": "numpy.random._sfc64:SFC64", "arbitrary": [], "local_refs": [ "seed" ] }