construct an element or isotope object - Maple Help

Online Help

All Products    Maple    MapleSim

Home : Support : Online Help : Science and Engineering : Scientific Constants : Functions : ScientificConstants/Element

ScientificConstants[Element] - construct an element or isotope object

Calling Sequence

Element( descriptor, prop, opts, 'units' )




name, symbol, or atomic number of an element, or isotope syntax of an isotope in the ScientificConstants package.



symbol or symbol(params); accepted element or isotope property, optionally with parameters params. For a list of properties, see Initial Properties for Elements and Isotopes



(optional) equation(s) of the form option=value, where option is one of 'system'; specify option(s) for object



(optional); specify that the object returned is an element object multiplied by a unit object



The Element( descriptor, prop ) command constructs an element or isotope object, which represents an accepted property of an element or isotope. The object can be used, for example, to access the value, see GetValue, or the uncertainty in its value, see GetError.


isotope syntax: An isotope in the ScientificConstants package is specified by using one of the three forms of the isotope syntax: an,mn, Xmn, yyyymn, Xmn, or yyyymn, where an is the atomic number, mn is the mass number, X is the element symbol, and yyyy is the element name.  It is an error to specify a mass number less than the (given or implied) atomic number.


For a complete list of elements, see Initial Elements of the Periodic Table. To list the isotopes of an element, use the 'element' option with the GetIsotopes function.


If no options are specified, an object is returned with no system of units. When such an object is evaluated or queried, it returns the property value in the current system of units. For more information, see Units[UsingSystem].


If the 'units' option is specified and the 'system' equation is not specified, the units are selected from the current system of units.


To access the value of an object with units, use the evalf function.


The opts argument can contain one or more of the following equations that set object options.




'system' = symbol


This option controls the system of units associated with the object. If the system specified is a system of units accepted by the Units package, the returned element or isotope object has the system of units specified in index notation. For a list of accepted systems of units, see Units/Systems. When such an object is evaluated or queried, it returns the element or isotope property value in the indicated system of units.


parameterized element properties and stored procedures: An Element object can refer to an element with a property that has its value or uncertainty defined by a stored procedure.  When such an object is evaluated (by evalf, GetValue, or GetError), the value or uncertainty is obtained by evaluating the stored procedure. The result is then passed to the required units conversion.


Furthermore, any parameters to the property given in the Element object are passed as arguments to the procedure when it is evaluated.  In such a case, the property is said to be parameterized.


If the property value is defined by a procedure, then at the time of construction of the Element object, a trial evaluation of the procedure is done (and the result is discarded).  This allows any error from a procedure defining the property value to be rethrown immediately at the time of construction of the Element object.  Any error from a procedure defining the property uncertainty is rethrown when the Element object is evaluated with GetError.


If parameters are given for the property in the Element constructor and the corresponding stored value is not a procedure, an error is returned. Or, if parameters are given and the corresponding stored uncertainty is not undefined and not a procedure, an error is returned.












The evalf function must be used to return the value of an element object multiplied by a unit object.







If a system is specified, it is used when displaying and returning the value of the property.















Error, (in ScientificConstants:-Element) element is a gas, access ideal density with parameter 'gas'

The previous example returns an error because the element is a gas. To get the density of a gas, density(gas) must be specified.




See Also

Details of Commands for Elements and Isotopes, Initial Elements of the Periodic Table, Initial Properties for Elements and Isotopes, ScientificConstants, ScientificConstants[GetElement], ScientificConstants[GetError], ScientificConstants[GetIsotopes], ScientificConstants[GetUnit], ScientificConstants[GetValue], Units/Systems, Units[Unit], Units[UsingSystem]

Download Help Document

Was this information helpful?

Please add your Comment (Optional)
E-mail Address (Optional)
What is ? This question helps us to combat spam