{ "__type": "IngestedDoc", "__tag": 4010, "_content": { "Notes": { "__type": "Section", "__tag": 4015, "children": [ { "__type": "Paragraph", "__tag": 4045, "children": [ { "__type": "Text", "__tag": 4046, "value": "If base is a scalar, logspace is equivalent to the code" } ] }, { "__type": "Code", "__tag": 4050, "value": ">>> y = np.linspace(start, stop, num=num, endpoint=endpoint)\n... # doctest: +SKIP\n>>> power(base, y).astype(dtype)\n... # doctest: +SKIP", "execution_status": null } ], "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": [ { "__type": "Parameters", "__tag": 4026, "children": [ { "__type": "DocParam", "__tag": 4016, "name": "samples", "annotation": "ndarray", "desc": [ { "__type": "Paragraph", "__tag": 4045, "children": [ { "__type": "ParamRef", "__tag": 4071, "name": "num" }, { "__type": "Text", "__tag": 4046, "value": " samples, equally spaced on a log scale." } ] } ] } ] } ], "title": [], "level": 0, "target": null }, "Summary": { "__type": "Section", "__tag": 4015, "children": [ { "__type": "Paragraph", "__tag": 4045, "children": [ { "__type": "Text", "__tag": 4046, "value": "Return numbers spaced evenly on a log scale." } ] } ], "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": "start", "annotation": "array_like", "desc": [ { "__type": "Paragraph", "__tag": 4045, "children": [ { "__type": "InlineCode", "__tag": 4051, "value": "base ** start" }, { "__type": "Text", "__tag": 4046, "value": " is the starting value of the sequence." } ] } ] }, { "__type": "DocParam", "__tag": 4016, "name": "stop", "annotation": "array_like", "desc": [ { "__type": "Paragraph", "__tag": 4045, "children": [ { "__type": "InlineCode", "__tag": 4051, "value": "base ** stop" }, { "__type": "Text", "__tag": 4046, "value": " is the final value of the sequence, unless " }, { "__type": "ParamRef", "__tag": 4071, "name": "endpoint" }, { "__type": "Text", "__tag": 4046, "value": " is False. In that case, " }, { "__type": "InlineCode", "__tag": 4051, "value": "num + 1" }, { "__type": "Text", "__tag": 4046, "value": " values are spaced over the interval in log-space, of which all but the last (a sequence of length " }, { "__type": "ParamRef", "__tag": 4071, "name": "num" }, { "__type": "Text", "__tag": 4046, "value": ") are returned." } ] } ] }, { "__type": "DocParam", "__tag": 4016, "name": "num", "annotation": "integer, optional", "desc": [ { "__type": "Paragraph", "__tag": 4045, "children": [ { "__type": "Text", "__tag": 4046, "value": "Number of samples to generate. Default is 50." } ] } ] }, { "__type": "DocParam", "__tag": 4016, "name": "endpoint", "annotation": "boolean, optional", "desc": [ { "__type": "Paragraph", "__tag": 4045, "children": [ { "__type": "Text", "__tag": 4046, "value": "If true, " }, { "__type": "ParamRef", "__tag": 4071, "name": "stop" }, { "__type": "Text", "__tag": 4046, "value": " is the last sample. Otherwise, it is not included. Default is True." } ] } ] }, { "__type": "DocParam", "__tag": 4016, "name": "base", "annotation": "array_like, optional", "desc": [ { "__type": "Paragraph", "__tag": 4045, "children": [ { "__type": "Text", "__tag": 4046, "value": "The base of the log space. The step size between the elements in " }, { "__type": "InlineCode", "__tag": 4051, "value": "ln(samples) / ln(base)" }, { "__type": "Text", "__tag": 4046, "value": " (or " }, { "__type": "InlineCode", "__tag": 4051, "value": "log_base(samples)" }, { "__type": "Text", "__tag": 4046, "value": ") is uniform. Default is 10.0." } ] } ] }, { "__type": "DocParam", "__tag": 4016, "name": "dtype", "annotation": "dtype", "desc": [ { "__type": "Paragraph", "__tag": 4045, "children": [ { "__type": "Text", "__tag": 4046, "value": "The type of the output array. If " }, { "__type": "ParamRef", "__tag": 4071, "name": "dtype" }, { "__type": "Text", "__tag": 4046, "value": " is not given, the data type is inferred from " }, { "__type": "ParamRef", "__tag": 4071, "name": "start" }, { "__type": "Text", "__tag": 4046, "value": " and " }, { "__type": "ParamRef", "__tag": 4071, "name": "stop" }, { "__type": "Text", "__tag": 4046, "value": ". The inferred type will never be an integer; " }, { "__type": "InlineRole", "__tag": 4003, "value": "float", "domain": null, "role": null, "inventory": null }, { "__type": "Text", "__tag": 4046, "value": " is chosen even if the arguments would produce an array of integers." } ] } ] }, { "__type": "DocParam", "__tag": 4016, "name": "axis", "annotation": "int, optional", "desc": [ { "__type": "Paragraph", "__tag": 4045, "children": [ { "__type": "Text", "__tag": 4046, "value": "The axis in the result to store the samples. Relevant only if start, stop, or base are array-like. By default (0), the samples will be along a new axis inserted at the beginning. Use -1 to get an axis at the end." } ] } ] } ] } ], "title": [], "level": 0, "target": null }, "Extended Summary": { "__type": "Section", "__tag": 4015, "children": [ { "__type": "Paragraph", "__tag": 4045, "children": [ { "__type": "Text", "__tag": 4046, "value": "In linear space, the sequence starts at " }, { "__type": "InlineCode", "__tag": 4051, "value": "base ** start" }, { "__type": "Text", "__tag": 4046, "value": " (" }, { "__type": "ParamRef", "__tag": 4071, "name": "base" }, { "__type": "Text", "__tag": 4046, "value": " to the power of " }, { "__type": "ParamRef", "__tag": 4071, "name": "start" }, { "__type": "Text", "__tag": 4046, "value": ") and ends with " }, { "__type": "InlineCode", "__tag": 4051, "value": "base ** stop" }, { "__type": "Text", "__tag": 4046, "value": " (see " }, { "__type": "ParamRef", "__tag": 4071, "name": "endpoint" }, { "__type": "Text", "__tag": 4046, "value": " below)." } ] }, { "__type": "Admonition", "__tag": 4056, "kind": "versionchanged", "base_type": "neutral", "children": [ { "__type": "AdmonitionTitle", "__tag": 4055, "children": [ { "__type": "Text", "__tag": 4046, "value": "versionchanged 1.25.0" } ] }, { "__type": "Paragraph", "__tag": 4045, "children": [ { "__type": "Text", "__tag": 4046, "value": "Non-scalar 'base` is now supported" } ] } ] } ], "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/_core/function_base.py", "item_line": 196, "item_type": "_ArrayFunctionDispatcher", "aliases": [ "numpy.logspace" ], "example_section_data": { "__type": "Section", "__tag": 4015, "children": [ { "__type": "Code", "__tag": 4050, "value": "import numpy as np\nnp.logspace(2.0, 3.0, num=4)\n", "execution_status": "success" }, { "__type": "Code", "__tag": 4050, "value": "np.logspace(2.0, 3.0, num=4, endpoint=False)\nnp.logspace(2.0, 3.0, num=4, base=2.0)\n", "execution_status": "failure" }, { "__type": "Code", "__tag": 4050, "value": "np.logspace(2.0, 3.0, num=4, base=[2.0, 3.0], axis=-1)\n", "execution_status": "success" }, { "__type": "Text", "__tag": 4046, "value": "\nGraphical illustration:\n\n" }, { "__type": "Code", "__tag": 4050, "value": "import matplotlib.pyplot as plt\nN = 10\nx1 = np.logspace(0.1, 1, N, endpoint=True)\nx2 = np.logspace(0.1, 1, N, endpoint=False)\ny = np.zeros(N)\nplt.plot(x1, y, 'o')\nplt.plot(x2, y + 0.5, 'o')\n", "execution_status": "success" }, { "__type": "Code", "__tag": 4050, "value": "plt.ylim([-0.5, 1])\n", "execution_status": "failure" }, { "__type": "Code", "__tag": 4050, "value": "plt.show()\n", "execution_status": "success" }, { "__type": "Figure", "__tag": 4024, "value": { "__type": "RefInfo", "__tag": 4000, "module": "numpy", "version": "2.4.3", "kind": "assets", "path": "fig-4e42094ba3b2b192.png" } } ], "title": [], "level": 0, "target": null }, "see_also": [ { "__type": "SeeAlsoItem", "__tag": 4028, "name": { "__type": "CrossRef", "__tag": 4002, "value": "arange", "reference": { "__type": "RefInfo", "__tag": 4000, "module": "current-module", "version": "current-version", "kind": "to-resolve", "path": "arange" }, "kind": "module" }, "descriptions": [ { "__type": "Paragraph", "__tag": 4045, "children": [ { "__type": "Text", "__tag": 4046, "value": "Similar to linspace, with the step size specified instead of the number of samples. Note that, when used with a float endpoint, the endpoint may or may not be included." } ] } ], "type": null }, { "__type": "SeeAlsoItem", "__tag": 4028, "name": { "__type": "CrossRef", "__tag": 4002, "value": "geomspace", "reference": { "__type": "RefInfo", "__tag": 4000, "module": "current-module", "version": "current-version", "kind": "to-resolve", "path": "geomspace" }, "kind": "module" }, "descriptions": [ { "__type": "Paragraph", "__tag": 4045, "children": [ { "__type": "Text", "__tag": 4046, "value": "Similar to logspace, but with endpoints specified directly." } ] } ], "type": null }, { "__type": "SeeAlsoItem", "__tag": 4028, "name": { "__type": "CrossRef", "__tag": 4002, "value": "how-to-partition", "reference": { "__type": "RefInfo", "__tag": 4000, "module": "current-module", "version": "current-version", "kind": "to-resolve", "path": "how-to-partition" }, "kind": "module" }, "descriptions": [ { "__type": "Paragraph", "__tag": 4045, "children": [ { "__type": "Text", "__tag": 4046, "value": "ref" } ] } ], "type": null }, { "__type": "SeeAlsoItem", "__tag": 4028, "name": { "__type": "CrossRef", "__tag": 4002, "value": "linspace", "reference": { "__type": "RefInfo", "__tag": 4000, "module": "current-module", "version": "current-version", "kind": "to-resolve", "path": "linspace" }, "kind": "module" }, "descriptions": [ { "__type": "Paragraph", "__tag": 4045, "children": [ { "__type": "Text", "__tag": 4046, "value": "Similar to logspace, but with the samples uniformly distributed in linear space, instead of log space." } ] } ], "type": null } ], "signature": { "__type": "SignatureNode", "__tag": 4029, "kind": "function", "parameters": [ { "__type": "SigParam", "__tag": 4030, "name": "start", "annotation": { "__type": "Empty", "__tag": 4031 }, "kind": "POSITIONAL_OR_KEYWORD", "default": { "__type": "Empty", "__tag": 4031 } }, { "__type": "SigParam", "__tag": 4030, "name": "stop", "annotation": { "__type": "Empty", "__tag": 4031 }, "kind": "POSITIONAL_OR_KEYWORD", "default": { "__type": "Empty", "__tag": 4031 } }, { "__type": "SigParam", "__tag": 4030, "name": "num", "annotation": { "__type": "Empty", "__tag": 4031 }, "kind": "POSITIONAL_OR_KEYWORD", "default": "50" }, { "__type": "SigParam", "__tag": 4030, "name": "endpoint", "annotation": { "__type": "Empty", "__tag": 4031 }, "kind": "POSITIONAL_OR_KEYWORD", "default": "True" }, { "__type": "SigParam", "__tag": 4030, "name": "base", "annotation": { "__type": "Empty", "__tag": 4031 }, "kind": "POSITIONAL_OR_KEYWORD", "default": "10.0" }, { "__type": "SigParam", "__tag": 4030, "name": "dtype", "annotation": { "__type": "Empty", "__tag": 4031 }, "kind": "POSITIONAL_OR_KEYWORD", "default": "None" }, { "__type": "SigParam", "__tag": 4030, "name": "axis", "annotation": { "__type": "Empty", "__tag": 4031 }, "kind": "POSITIONAL_OR_KEYWORD", "default": "0" } ], "return_annotation": { "__type": "Empty", "__tag": 4031 }, "target_name": "logspace" }, "references": null, "qa": "numpy:logspace", "arbitrary": [], "local_refs": [ "axis", "base", "dtype", "endpoint", "num", "samples", "start", "stop" ] }