mathjs-min 11.7.2

package/lib/cjs/type/unit/function/createUnit.js

@@ -0,0 +1,84 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.createCreateUnit = void 0;
+var _factory = require("../../../utils/factory.js");
+var name = 'createUnit';
+var dependencies = ['typed', 'Unit'];
+var createCreateUnit = /* #__PURE__ */(0, _factory.factory)(name, dependencies, function (_ref) {
+  var typed = _ref.typed,
+    Unit = _ref.Unit;
+  /**
+   * Create a user-defined unit and register it with the Unit type.
+   *
+   * Syntax:
+   *
+   *     math.createUnit({
+   *       baseUnit1: {
+   *         aliases: [string, ...]
+   *         prefixes: object
+   *       },
+   *       unit2: {
+   *         definition: string,
+   *         aliases: [string, ...]
+   *         prefixes: object,
+   *         offset: number
+   *       },
+   *       unit3: string    // Shortcut
+   *     })
+   *
+   *     // Another shortcut:
+   *     math.createUnit(string, unit : string, [object])
+   *
+   * Examples:
+   *
+   *     math.createUnit('foo')
+   *     math.createUnit('knot', {definition: '0.514444444 m/s', aliases: ['knots', 'kt', 'kts']})
+   *     math.createUnit('mph', '1 mile/hour')
+   *     math.createUnit('km', math.unit(1000, 'm'))
+   *
+   * @param {string} name      The name of the new unit. Must be unique. Example: 'knot'
+   * @param {string, UnitDefinition, Unit} definition      Definition of the unit in terms of existing units. For example, '0.514444444 m / s'.
+   * @param {Object} options   (optional) An object containing any of the following properties:
+   *     - `prefixes {string}` "none", "short", "long", "binary_short", or "binary_long". The default is "none".
+   *     - `aliases {Array}` Array of strings. Example: ['knots', 'kt', 'kts']
+   *     - `offset {Numeric}` An offset to apply when converting from the unit. For example, the offset for celsius is 273.15. Default is 0.
+   *
+   * See also:
+   *
+   *     unit
+   *
+   * @return {Unit} The new unit
+   */
+  return typed(name, {
+    // General function signature. First parameter is an object where each property is the definition of a new unit. The object keys are the unit names and the values are the definitions. The values can be objects, strings, or Units. If a property is an empty object or an empty string, a new base unit is created. The second parameter is the options.
+    'Object, Object': function ObjectObject(obj, options) {
+      return Unit.createUnit(obj, options);
+    },
+    // Same as above but without the options.
+    Object: function Object(obj) {
+      return Unit.createUnit(obj, {});
+    },
+    // Shortcut method for creating one unit.
+    'string, Unit | string | Object, Object': function stringUnitStringObjectObject(name, def, options) {
+      var obj = {};
+      obj[name] = def;
+      return Unit.createUnit(obj, options);
+    },
+    // Same as above but without the options.
+    'string, Unit | string | Object': function stringUnitStringObject(name, def) {
+      var obj = {};
+      obj[name] = def;
+      return Unit.createUnit(obj, {});
+    },
+    // Without a definition, creates a base unit.
+    string: function string(name) {
+      var obj = {};
+      obj[name] = {};
+      return Unit.createUnit(obj, {});
+    }
+  });
+});
+exports.createCreateUnit = createCreateUnit;

package/lib/cjs/type/unit/function/splitUnit.js

@@ -0,0 +1,37 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.createSplitUnit = void 0;
+var _factory = require("../../../utils/factory.js");
+var name = 'splitUnit';
+var dependencies = ['typed'];
+var createSplitUnit = /* #__PURE__ */(0, _factory.factory)(name, dependencies, function (_ref) {
+  var typed = _ref.typed;
+  /**
+   * Split a unit in an array of units whose sum is equal to the original unit.
+   *
+   * Syntax:
+   *
+   *     splitUnit(unit: Unit, parts: Array.<Unit>)
+   *
+   * Example:
+   *
+   *     math.splitUnit(new Unit(1, 'm'), ['feet', 'inch'])
+   *     // [ 3 feet, 3.3700787401575 inch ]
+   *
+   * See also:
+   *
+   *     unit
+   *
+   * @param {Array} [parts] An array of strings or valueless units.
+   * @return {Array} An array of units.
+   */
+  return typed(name, {
+    'Unit, Array': function UnitArray(unit, parts) {
+      return unit.splitUnit(parts);
+    }
+  });
+});
+exports.createSplitUnit = createSplitUnit;

package/lib/cjs/type/unit/function/unit.js

@@ -0,0 +1,71 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.createUnitFunction = void 0;
+var _factory = require("../../../utils/factory.js");
+var _collection = require("../../../utils/collection.js");
+var name = 'unit';
+var dependencies = ['typed', 'Unit'];
+
+// This function is named createUnitFunction to prevent a naming conflict with createUnit
+var createUnitFunction = /* #__PURE__ */(0, _factory.factory)(name, dependencies, function (_ref) {
+  var typed = _ref.typed,
+    Unit = _ref.Unit;
+  /**
+   * Create a unit. Depending on the passed arguments, the function
+   * will create and return a new math.Unit object.
+   * When a matrix is provided, all elements will be converted to units.
+   *
+   * Syntax:
+   *
+   *     math.unit(unit : string)
+   *     math.unit(value : number, valuelessUnit : Unit)
+   *     math.unit(value : number, valuelessUnit : string)
+   *
+   * Examples:
+   *
+   *    const kph = math.unit('km/h')   // returns Unit km/h (valueless)
+   *    const v = math.unit(25, kph)    // returns Unit 25 km/h
+   *    const a = math.unit(5, 'cm')    // returns Unit 50 mm
+   *    const b = math.unit('23 kg')    // returns Unit 23 kg
+   *    a.to('m')                       // returns Unit 0.05 m
+   *
+   * See also:
+   *
+   *    bignumber, boolean, complex, index, matrix, number, string, createUnit
+   *
+   * @param {* | Array | Matrix} args   A number and unit.
+   * @return {Unit | Array | Matrix}    The created unit
+   */
+
+  return typed(name, {
+    Unit: function Unit(x) {
+      return x.clone();
+    },
+    string: function string(x) {
+      if (Unit.isValuelessUnit(x)) {
+        return new Unit(null, x); // a pure unit
+      }
+
+      return Unit.parse(x, {
+        allowNoUnits: true
+      }); // a unit with value, like '5cm'
+    },
+
+    'number | BigNumber | Fraction | Complex, string | Unit': function numberBigNumberFractionComplexStringUnit(value, unit) {
+      return new Unit(value, unit);
+    },
+    'number | BigNumber | Fraction': function numberBigNumberFraction(value) {
+      // dimensionless
+      return new Unit(value);
+    },
+    'Array | Matrix': typed.referToSelf(function (self) {
+      return function (x) {
+        return (0, _collection.deepMap)(x, self);
+      };
+    })
+  });
+});
+exports.createUnitFunction = createUnitFunction;

package/lib/cjs/type/unit/physicalConstants.js

@@ -0,0 +1,153 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.createWienDisplacement = exports.createWeakMixingAngle = exports.createVacuumImpedance = exports.createThomsonCrossSection = exports.createStefanBoltzmann = exports.createSpeedOfLight = exports.createSecondRadiation = exports.createSackurTetrode = exports.createRydberg = exports.createReducedPlanckConstant = exports.createQuantumOfCirculation = exports.createProtonMass = exports.createPlanckTime = exports.createPlanckTemperature = exports.createPlanckMass = exports.createPlanckLength = exports.createPlanckConstant = exports.createPlanckCharge = exports.createNuclearMagneton = exports.createNeutronMass = exports.createMolarVolume = exports.createMolarPlanckConstant = exports.createMolarMassC12 = exports.createMolarMass = exports.createMagneticFluxQuantum = exports.createMagneticConstant = exports.createLoschmidt = exports.createKlitzing = exports.createJosephson = exports.createInverseConductanceQuantum = exports.createHartreeEnergy = exports.createGravity = exports.createGravitationConstant = exports.createGasConstant = exports.createFirstRadiation = exports.createFineStructure = exports.createFermiCoupling = exports.createFaraday = exports.createElementaryCharge = exports.createElectronMass = exports.createElectricConstant = exports.createEfimovFactor = exports.createDeuteronMass = exports.createCoulomb = exports.createConductanceQuantum = exports.createClassicalElectronRadius = exports.createBoltzmann = exports.createBohrRadius = exports.createBohrMagneton = exports.createAvogadro = exports.createAtomicMass = void 0;
+var _factory = require("../../utils/factory.js");
+// Source: https://en.wikipedia.org/wiki/Physical_constant
+
+// Universal constants
+var createSpeedOfLight = /* #__PURE__ */unitFactory('speedOfLight', '299792458', 'm s^-1');
+exports.createSpeedOfLight = createSpeedOfLight;
+var createGravitationConstant = /* #__PURE__ */unitFactory('gravitationConstant', '6.67430e-11', 'm^3 kg^-1 s^-2');
+exports.createGravitationConstant = createGravitationConstant;
+var createPlanckConstant = /* #__PURE__ */unitFactory('planckConstant', '6.62607015e-34', 'J s');
+exports.createPlanckConstant = createPlanckConstant;
+var createReducedPlanckConstant = /* #__PURE__ */unitFactory('reducedPlanckConstant', '1.0545718176461565e-34', 'J s');
+
+// Electromagnetic constants
+exports.createReducedPlanckConstant = createReducedPlanckConstant;
+var createMagneticConstant = /* #__PURE__ */unitFactory('magneticConstant', '1.25663706212e-6', 'N A^-2');
+exports.createMagneticConstant = createMagneticConstant;
+var createElectricConstant = /* #__PURE__ */unitFactory('electricConstant', '8.8541878128e-12', 'F m^-1');
+exports.createElectricConstant = createElectricConstant;
+var createVacuumImpedance = /* #__PURE__ */unitFactory('vacuumImpedance', '376.730313667', 'ohm');
+exports.createVacuumImpedance = createVacuumImpedance;
+var createCoulomb = /* #__PURE__ */unitFactory('coulomb', '8.987551792261171e9', 'N m^2 C^-2');
+exports.createCoulomb = createCoulomb;
+var createElementaryCharge = /* #__PURE__ */unitFactory('elementaryCharge', '1.602176634e-19', 'C');
+exports.createElementaryCharge = createElementaryCharge;
+var createBohrMagneton = /* #__PURE__ */unitFactory('bohrMagneton', '9.2740100783e-24', 'J T^-1');
+exports.createBohrMagneton = createBohrMagneton;
+var createConductanceQuantum = /* #__PURE__ */unitFactory('conductanceQuantum', '7.748091729863649e-5', 'S');
+exports.createConductanceQuantum = createConductanceQuantum;
+var createInverseConductanceQuantum = /* #__PURE__ */unitFactory('inverseConductanceQuantum', '12906.403729652257', 'ohm');
+exports.createInverseConductanceQuantum = createInverseConductanceQuantum;
+var createMagneticFluxQuantum = /* #__PURE__ */unitFactory('magneticFluxQuantum', '2.0678338484619295e-15', 'Wb');
+exports.createMagneticFluxQuantum = createMagneticFluxQuantum;
+var createNuclearMagneton = /* #__PURE__ */unitFactory('nuclearMagneton', '5.0507837461e-27', 'J T^-1');
+exports.createNuclearMagneton = createNuclearMagneton;
+var createKlitzing = /* #__PURE__ */unitFactory('klitzing', '25812.807459304513', 'ohm');
+exports.createKlitzing = createKlitzing;
+var createJosephson = /* #__PURE__ */unitFactory('josephson', '4.835978484169836e14 Hz V', 'Hz V^-1'); // TODO: support for Hz needed
+
+// Atomic and nuclear constants
+exports.createJosephson = createJosephson;
+var createBohrRadius = /* #__PURE__ */unitFactory('bohrRadius', '5.29177210903e-11', 'm');
+exports.createBohrRadius = createBohrRadius;
+var createClassicalElectronRadius = /* #__PURE__ */unitFactory('classicalElectronRadius', '2.8179403262e-15', 'm');
+exports.createClassicalElectronRadius = createClassicalElectronRadius;
+var createElectronMass = /* #__PURE__ */unitFactory('electronMass', '9.1093837015e-31', 'kg');
+exports.createElectronMass = createElectronMass;
+var createFermiCoupling = /* #__PURE__ */unitFactory('fermiCoupling', '1.1663787e-5', 'GeV^-2');
+exports.createFermiCoupling = createFermiCoupling;
+var createFineStructure = numberFactory('fineStructure', 7.2973525693e-3);
+exports.createFineStructure = createFineStructure;
+var createHartreeEnergy = /* #__PURE__ */unitFactory('hartreeEnergy', '4.3597447222071e-18', 'J');
+exports.createHartreeEnergy = createHartreeEnergy;
+var createProtonMass = /* #__PURE__ */unitFactory('protonMass', '1.67262192369e-27', 'kg');
+exports.createProtonMass = createProtonMass;
+var createDeuteronMass = /* #__PURE__ */unitFactory('deuteronMass', '3.3435830926e-27', 'kg');
+exports.createDeuteronMass = createDeuteronMass;
+var createNeutronMass = /* #__PURE__ */unitFactory('neutronMass', '1.6749271613e-27', 'kg');
+exports.createNeutronMass = createNeutronMass;
+var createQuantumOfCirculation = /* #__PURE__ */unitFactory('quantumOfCirculation', '3.6369475516e-4', 'm^2 s^-1');
+exports.createQuantumOfCirculation = createQuantumOfCirculation;
+var createRydberg = /* #__PURE__ */unitFactory('rydberg', '10973731.568160', 'm^-1');
+exports.createRydberg = createRydberg;
+var createThomsonCrossSection = /* #__PURE__ */unitFactory('thomsonCrossSection', '6.6524587321e-29', 'm^2');
+exports.createThomsonCrossSection = createThomsonCrossSection;
+var createWeakMixingAngle = numberFactory('weakMixingAngle', 0.22290);
+exports.createWeakMixingAngle = createWeakMixingAngle;
+var createEfimovFactor = numberFactory('efimovFactor', 22.7);
+
+// Physico-chemical constants
+exports.createEfimovFactor = createEfimovFactor;
+var createAtomicMass = /* #__PURE__ */unitFactory('atomicMass', '1.66053906660e-27', 'kg');
+exports.createAtomicMass = createAtomicMass;
+var createAvogadro = /* #__PURE__ */unitFactory('avogadro', '6.02214076e23', 'mol^-1');
+exports.createAvogadro = createAvogadro;
+var createBoltzmann = /* #__PURE__ */unitFactory('boltzmann', '1.380649e-23', 'J K^-1');
+exports.createBoltzmann = createBoltzmann;
+var createFaraday = /* #__PURE__ */unitFactory('faraday', '96485.33212331001', 'C mol^-1');
+exports.createFaraday = createFaraday;
+var createFirstRadiation = /* #__PURE__ */unitFactory('firstRadiation', '3.7417718521927573e-16', 'W m^2');
+// export const createSpectralRadiance = /* #__PURE__ */ unitFactory('spectralRadiance', '1.1910429723971881e-16', 'W m^2 sr^-1') // TODO spectralRadiance
+exports.createFirstRadiation = createFirstRadiation;
+var createLoschmidt = /* #__PURE__ */unitFactory('loschmidt', '2.686780111798444e25', 'm^-3');
+exports.createLoschmidt = createLoschmidt;
+var createGasConstant = /* #__PURE__ */unitFactory('gasConstant', '8.31446261815324', 'J K^-1 mol^-1');
+exports.createGasConstant = createGasConstant;
+var createMolarPlanckConstant = /* #__PURE__ */unitFactory('molarPlanckConstant', '3.990312712893431e-10', 'J s mol^-1');
+exports.createMolarPlanckConstant = createMolarPlanckConstant;
+var createMolarVolume = /* #__PURE__ */unitFactory('molarVolume', '0.022413969545014137', 'm^3 mol^-1');
+exports.createMolarVolume = createMolarVolume;
+var createSackurTetrode = numberFactory('sackurTetrode', -1.16487052358);
+exports.createSackurTetrode = createSackurTetrode;
+var createSecondRadiation = /* #__PURE__ */unitFactory('secondRadiation', '0.014387768775039337', 'm K');
+exports.createSecondRadiation = createSecondRadiation;
+var createStefanBoltzmann = /* #__PURE__ */unitFactory('stefanBoltzmann', '5.67037441918443e-8', 'W m^-2 K^-4');
+exports.createStefanBoltzmann = createStefanBoltzmann;
+var createWienDisplacement = /* #__PURE__ */unitFactory('wienDisplacement', '2.897771955e-3', 'm K');
+
+// Adopted values
+exports.createWienDisplacement = createWienDisplacement;
+var createMolarMass = /* #__PURE__ */unitFactory('molarMass', '0.99999999965e-3', 'kg mol^-1');
+exports.createMolarMass = createMolarMass;
+var createMolarMassC12 = /* #__PURE__ */unitFactory('molarMassC12', '11.9999999958e-3', 'kg mol^-1');
+exports.createMolarMassC12 = createMolarMassC12;
+var createGravity = /* #__PURE__ */unitFactory('gravity', '9.80665', 'm s^-2');
+// atm is defined in Unit.js
+
+// Natural units
+exports.createGravity = createGravity;
+var createPlanckLength = /* #__PURE__ */unitFactory('planckLength', '1.616255e-35', 'm');
+exports.createPlanckLength = createPlanckLength;
+var createPlanckMass = /* #__PURE__ */unitFactory('planckMass', '2.176435e-8', 'kg');
+exports.createPlanckMass = createPlanckMass;
+var createPlanckTime = /* #__PURE__ */unitFactory('planckTime', '5.391245e-44', 's');
+exports.createPlanckTime = createPlanckTime;
+var createPlanckCharge = /* #__PURE__ */unitFactory('planckCharge', '1.87554603778e-18', 'C');
+exports.createPlanckCharge = createPlanckCharge;
+var createPlanckTemperature = /* #__PURE__ */unitFactory('planckTemperature', '1.416785e+32', 'K');
+
+// helper function to create a factory function which creates a physical constant,
+// a Unit with either a number value or a BigNumber value depending on the configuration
+exports.createPlanckTemperature = createPlanckTemperature;
+function unitFactory(name, valueStr, unitStr) {
+  var dependencies = ['config', 'Unit', 'BigNumber'];
+  return (0, _factory.factory)(name, dependencies, function (_ref) {
+    var config = _ref.config,
+      Unit = _ref.Unit,
+      BigNumber = _ref.BigNumber;
+    // Note that we can parse into number or BigNumber.
+    // We do not parse into Fractions as that doesn't make sense: we would lose precision of the values
+    // Therefore we dont use Unit.parse()
+    var value = config.number === 'BigNumber' ? new BigNumber(valueStr) : parseFloat(valueStr);
+    var unit = new Unit(value, unitStr);
+    unit.fixPrefix = true;
+    return unit;
+  });
+}
+
+// helper function to create a factory function which creates a numeric constant,
+// either a number or BigNumber depending on the configuration
+function numberFactory(name, value) {
+  var dependencies = ['config', 'BigNumber'];
+  return (0, _factory.factory)(name, dependencies, function (_ref2) {
+    var config = _ref2.config,
+      BigNumber = _ref2.BigNumber;
+    return config.number === 'BigNumber' ? new BigNumber(value) : value;
+  });
+}