Element - Maple Help
For the best experience, we recommend viewing online help using Google Chrome or Microsoft Edge.

Online Help

All Products    Maple    MapleSim


ScientificConstants

  

Element

  

construct an element or isotope object

 

Calling Sequence

Parameters

Description

Examples

Calling Sequence

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

Parameters

descriptor

-

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

prop

-

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

opts

-

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

'units'

-

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

Description

• 

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.

Examples

withScientificConstants

AddConstant,AddElement,AddProperty,Constant,Element,GetConstant,GetConstants,GetElement,GetElements,GetError,GetIsotopes,GetProperties,GetProperty,GetUnit,GetValue,HasConstant,HasElement,HasProperty,ModifyConstant,ModifyElement

(1)

ElementNa23,atomicmass

ElementNa23,atomicmass

(2)

GetValue;GetUnit

3.817543673×10−26

kg

(3)

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

ElementNa23,atomicmass,units

ElementSINa23,atomicmasskg

(4)

evalf

3.817543673×10−26kg

(5)

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

ElementNa23,atomicmass,system=CGS

ElementCGSNa23,atomicmass

(6)

GetValue;GetUnit

3.817543673×10−23

g

(7)

Element11,23,atomicmass

ElementNa23,atomicmass

(8)

ElementMo,atomicweight

ElementMo,atomicweight

(9)

ElementO,density

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.

ElementO,densitygas

ElementO,densitygas

(10)

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]