ResourceFunction

Wolfram Function Repository »

ResourceFunction[resource]

represents the function associated with the specified resource.

ResourceFunction[resource,prop]

gives the specified property of the resource.

Details and Options

  • ResourceFunction["name"] searches in order for a resource function with the specified name in the following locations:
  • locally in the session (for resource functions from DefineResourceFunction)
    at the locations specified by $PersistencePath
    in the Wolfram Function Repository
  • In ResourceFunction[resource], resource can have the following forms:
  • "name"function name, resolved as described
    ResourceObject[]a resource object of type "Function" stored at any location
    CloudObject[]a cloud object containing a function resource object
    LocalObject[]a local object containing a function resource object
  • ResourceFunction[resource][args ] applies the function to the given arguments.
  • The available properties are given by ResourceFunction[resource,"Properties"] and typically include properties of the ResourceObject as well as:
  • "SymbolName"fully qualified string name of the underlying function
    "FunctionLocation"file, object or method used to store the definition
    "DocumentationLink"URL for documentation of a published function
  • ResourceFunction accepts the following options:
  • ResourceSystemPath $ResourceSystemPathwhere to look for a function
    ResourceVersion Automaticversion to select of a published resource
  • Function definitions in a function resource are typically not explicitly retrieved until the function is used.
  • When the definitions for a function resource are retrieved, they are usually cached in $LocalBase.
  • ResourceObject[ResourceFunction[]] returns the resource object containing the given function.
  • ResourceFunction[ResourceFunction[],prop] gives a property for an existing resource function.
  • CloudDeploy[ResourceFunction[]] or CloudPublish[ResourceFunction[]] saves a resource function in the cloud.
  • LocalCache[ResourceFunction[]] saves a resource function as a LocalObject[].
  • The following functions work on ResourceFunction objects: Attributes, Definition, DownValues, FullDefinition, Options and SymbolName.
  • New resource functions can be defined with DefineResourceFunction or with a definition notebook from File New Repository Item Function Repository Item.

Examples

open allclose all

Basic Examples  (5)

Get a resource function using its name:

Apply the resource function to arguments:

Apply a function from a ResourceObject to a value:

Find properties of a resource function:

Get the web documentation URL for a published function:

Create a resource function from an Association:

Scope  (7)

Use the two-argument from of ResourceFunction to retrieve properties:

Get a list of properties:

Obtain information on a resource function:

View basic usage:

Run all verification tests defined for a resource function to generate a TestReportObject:

A Missing object is returned for resource functions that do not have defined tests:

See all the tests defined for a resource function in a testing notebook:

See when a resource function was first published to the Wolfram Function Repository:

Get the date of the most recent update:

Get a list of available versions:

Options  (3)

ResourceSystemPath  (2)

Use ResourceSystemPath to limit the result to only find functions published in the function repository:

Create a new resource function with the same name as a deployed function:

Use ResourceSystemPath to ensure this resource is found:

Instead, find the published function:

ResourceVersion  (1)

Get two versions of the same resource from the function repository using ResourceVersion:

Only the newer version supports a zero-argument form:

Properties & Relations  (3)

The two-argument form of ResourceFunction provides the same values as ResourceObject:

The underlying symbol belonging to a ResourceFunction can be obtained using the "Function" property:

Using the symbol directly can often be faster:

Many functions that work on symbols also work on resource functions, for example, DownValues:

And Attributes:

And Options:

Possible Issues  (1)

Resource functions that have holding attributes will only hold arguments if ResourceFunction[] is explicitly used as the head:

Use ResourceFunction[][] instead to ensure attributes will work:

Using the formatted form will also work:

Alternatively, set the symbol to the underlying function instead:

Wolfram Research (2019), ResourceFunction, Wolfram Language function, https://reference.wolfram.com/language/ref/ResourceFunction.html.

Text

Wolfram Research (2019), ResourceFunction, Wolfram Language function, https://reference.wolfram.com/language/ref/ResourceFunction.html.

CMS

Wolfram Language. 2019. "ResourceFunction." Wolfram Language & System Documentation Center. Wolfram Research. https://reference.wolfram.com/language/ref/ResourceFunction.html.

APA

Wolfram Language. (2019). ResourceFunction. Wolfram Language & System Documentation Center. Retrieved from https://reference.wolfram.com/language/ref/ResourceFunction.html

BibTeX

@misc{reference.wolfram_2024_resourcefunction, author="Wolfram Research", title="{ResourceFunction}", year="2019", howpublished="\url{https://reference.wolfram.com/language/ref/ResourceFunction.html}", note=[Accessed: 21-November-2024 ]}

BibLaTeX

@online{reference.wolfram_2024_resourcefunction, organization={Wolfram Research}, title={ResourceFunction}, year={2019}, url={https://reference.wolfram.com/language/ref/ResourceFunction.html}, note=[Accessed: 21-November-2024 ]}