Loading...

vastorbit.machine_learning.vast.preprocessing.balance

vastorbit.machine_learning.vast.preprocessing.balance(name: str, input_relation: str, y: str, method: Literal['hybrid', 'over', 'under'] = 'hybrid', ratio: float = 0.5) VastFrame

Creates a view with an equal distribution of the input data based on the response_column.

Parameters:
  • name (str) – Name of the view.

  • input_relation (str) – Relation used to create the new relation.

  • y (str) – Response column.

  • method (str, optional) –

    Method used to do the balancing.

    • hybrid:

      Performs over-sampling and under-sampling on different classes so that each class is equally represented.

    • over:

      Over-samples on all classes, except the most represented class, towards the most represented class’s cardinality.

    • under:

      Under-samples on all classes, except the least represented class, towards the least represented class’s cardinality.

  • ratio (float, optional) – The desired ratio between the majority class and the minority class. This value has no effect when used with the ‘hybrid’ balance method.

Returns:

VastFrame of the created view.

Return type:

VastFrame

Examples

The following examples provide a basic understanding of usage. For more detailed examples, please refer to the Machine Learning or the Examples section on the website.

Load data for machine learning

We import vastorbit:

import vastorbit as vo

Hint

By assigning an alias to vastorbit, we mitigate the risk of code collisions with other libraries. This precaution is necessary because vastorbit uses commonly known function names like “average” and “median”, which can potentially lead to naming conflicts. The use of an alias ensures that the functions from vastorbit are used as intended without interfering with functions from other libraries.

For this example, we will use the Titanic dataset.

import vastorbit.datasets as vod

data = vod.load_titanic()
123
pclass
Integer
123
survived
Integer
Abc
name
Varchar(164)
Abc
sex
Varchar(20)
123
age
Double
123
sibsp
Integer
123
parch
Integer
Abc
ticket
Varchar(36)
123
fare
Double
Abc
cabin
Varchar(30)
Abc
embarked
Varchar(20)
Abc
boat
Varchar(100)
123
body
Integer
Abc
home.dest
Varchar(100)
131McCormack, Mr. Thomas Josephmale[null]003672287.75[null]Q[null][null][null]
231McCoy, Miss. Agnesfemale[null]2036722623.25[null]Q16[null][null]
331McCoy, Miss. Aliciafemale[null]2036722623.25[null]Q16[null][null]
431McCoy, Mr. Bernardmale[null]2036722623.25[null]Q16[null][null]
531McDermott, Miss. Brigdet Deliafemale[null]003309327.7875[null]Q13[null][null]
630McEvoy, Mr. Michaelmale[null]003656815.5[null]Q[null][null][null]
731McGovern, Miss. Maryfemale[null]003309317.8792[null]Q13[null][null]
831McGowan, Miss. Anna "Annie"female15.0003309238.0292[null]Q[null][null][null]
930McGowan, Miss. Katherinefemale35.00092327.75[null]Q[null][null][null]
1030McMahon, Mr. Martinmale[null]003703727.75[null]Q[null][null][null]
1130McNamee, Mr. Nealmale24.01037656616.1[null]S[null][null][null]
1230McNamee, Mrs. Neal (Eileen O'Leary)female19.01037656616.1[null]S[null]53[null]
1330McNeill, Miss. Bridgetfemale[null]003703687.75[null]Q[null][null][null]
1430Meanwell, Miss. (Marion Ogden)female[null]00SOTON/O.Q. 3920878.05[null]S[null][null][null]
1530Meek, Mrs. Thomas (Annie Louise Rowley)female[null]003430958.05[null]S[null][null][null]
1630Meo, Mr. Alfonzomale55.500A.5. 112068.05[null]S[null]201[null]
1730Mernagh, Mr. Robertmale[null]003687037.75[null]Q[null][null][null]
1831Midtsjo, Mr. Karl Albertmale21.0003455017.775[null]S15[null][null]
1930Miles, Mr. Frankmale[null]003593068.05[null]S[null][null][null]
2030Mineff, Mr. Ivanmale24.0003492337.8958[null]S[null][null][null]
2130Minkoff, Mr. Lazarmale21.0003492117.8958[null]S[null][null][null]
2230Mionoff, Mr. Stoytchomale28.0003492077.8958[null]S[null][null][null]
2330Mitkoff, Mr. Mitomale[null]003492217.8958[null]S[null][null][null]
2431Mockler, Miss. Helen Mary "Ellie"female[null]003309807.8792[null]Q16[null][null]
2530Moen, Mr. Sigurd Hansenmale25.0003481237.65F G73S[null]309[null]
2631Moor, Master. Meiermale6.00139209612.475E121S14[null][null]
2731Moor, Mrs. (Beila)female27.00139209612.475E121S14[null][null]
2830Moore, Mr. Leonard Charlesmale[null]00A4. 545108.05[null]S[null][null][null]
2931Moran, Miss. Berthafemale[null]1037111024.15[null]Q16[null][null]
3030Moran, Mr. Daniel Jmale[null]1037111024.15[null]Q[null][null][null]
3130Moran, Mr. Jamesmale[null]003308778.4583[null]Q[null][null][null]
3230Morley, Mr. Williammale34.0003645068.05[null]S[null][null][null]
3330Morrow, Mr. Thomas Rowanmale[null]003726227.75[null]Q[null][null][null]
3431Moss, Mr. Albert Johanmale[null]003129917.775[null]SB[null][null]
3531Moubarek, Master. Geriosmale[null]11266115.2458[null]CC[null][null]
3631Moubarek, Master. Halim Gonios ("William George")male[null]11266115.2458[null]CC[null][null]
3731Moubarek, Mrs. George (Omine "Amenia" Alexander)female[null]02266115.2458[null]CC[null][null]
3831Moussa, Mrs. (Mantoura Boulos)female[null]0026267.2292[null]C[null][null][null]
3930Moutal, Mr. Rahamin Haimmale[null]003747468.05[null]S[null][null][null]
4031Mullens, Miss. Katherine "Katie"female[null]00358527.7333[null]Q16[null][null]
4131Mulvihill, Miss. Bertha Efemale24.0003826537.75[null]Q15[null][null]
4230Murdlin, Mr. Josephmale[null]00A./5. 32358.05[null]S[null][null][null]
4331Murphy, Miss. Katherine "Kate"female[null]1036723015.5[null]Q16[null][null]
4431Murphy, Miss. Margaret Janefemale[null]1036723015.5[null]Q16[null][null]
4531Murphy, Miss. Norafemale[null]003656815.5[null]Q16[null][null]
4630Myhrman, Mr. Pehr Fabian Oliver Malkolmmale18.0003470787.75[null]S[null][null][null]
4730Naidenoff, Mr. Penkomale22.0003492067.8958[null]S[null][null][null]
4831Najib, Miss. Adele Kiamie "Jane"female15.00026677.225[null]CC[null][null]
4931Nakid, Miss. Maria ("Mary")female1.002265315.7417[null]CC[null][null]
5031Nakid, Mr. Sahidmale20.011265315.7417[null]CC[null][null]
5131Nakid, Mrs. Said (Waika "Mary" Mowad)female19.011265315.7417[null]CC[null][null]
5230Nancarrow, Mr. William Henrymale33.000A./5. 33388.05[null]S[null][null][null]
5330Nankoff, Mr. Minkomale[null]003492187.8958[null]S[null][null][null]
5430Nasr, Mr. Mustafamale[null]0026527.2292[null]C[null][null][null]
5530Naughton, Miss. Hannahfemale[null]003652377.75[null]Q[null][null][null]
5630Nenkoff, Mr. Christomale[null]003492347.8958[null]S[null][null][null]
5731Nicola-Yarred, Master. Eliasmale12.010265111.2417[null]CC[null][null]
5831Nicola-Yarred, Miss. Jamilafemale14.010265111.2417[null]CC[null][null]
5930Nieminen, Miss. Manta Josefinafemale29.00031012977.925[null]S[null][null][null]
6030Niklasson, Mr. Samuelmale28.0003636118.05[null]S[null][null][null]
6131Nilsson, Miss. Berta Oliviafemale18.0003470667.775[null]SD[null][null]
6231Nilsson, Miss. Helmina Josefinafemale26.0003474707.8542[null]S13[null][null]
6330Nilsson, Mr. August Ferdinandmale21.0003504107.8542[null]S[null][null][null]
6430Nirva, Mr. Iisakki Antino Aijomale41.000SOTON/O2 31012727.125[null]S[null][null]Finland Sudbury, ON
6531Niskanen, Mr. Juhamale39.000STON/O 2. 31012897.925[null]S9[null][null]
6630Nosworthy, Mr. Richard Catermale21.000A/4. 398867.8[null]S[null][null][null]
6730Novel, Mr. Mansouermale28.50026977.2292[null]C[null]181[null]
6831Nysten, Miss. Anna Sofiafemale22.0003470817.75[null]S13[null][null]
6930Nysveen, Mr. Johan Hansenmale61.0003453646.2375[null]S[null][null][null]
7030O'Brien, Mr. Thomasmale[null]1037036515.5[null]Q[null][null][null]
7130O'Brien, Mr. Timothymale[null]003309797.8292[null]Q[null][null][null]
7231O'Brien, Mrs. Thomas (Johanna "Hannah" Godfrey)female[null]1037036515.5[null]Q[null][null][null]
7330O'Connell, Mr. Patrick Dmale[null]003349127.7333[null]Q[null][null][null]
7430O'Connor, Mr. Mauricemale[null]003710607.75[null]Q[null][null][null]
7530O'Connor, Mr. Patrickmale[null]003667137.75[null]Q[null][null][null]
7630Odahl, Mr. Nils Martinmale23.00072679.225[null]S[null][null][null]
7730O'Donoghue, Ms. Bridgetfemale[null]003648567.75[null]Q[null][null][null]
7831O'Driscoll, Miss. Bridgetfemale[null]00143117.75[null]QD[null][null]
7931O'Dwyer, Miss. Ellen "Nellie"female[null]003309597.8792[null]Q[null][null][null]
8031Ohman, Miss. Velinfemale22.0003470857.775[null]SC[null][null]
8131O'Keefe, Mr. Patrickmale[null]003684027.75[null]QB[null][null]
8231O'Leary, Miss. Hanora "Norah"female[null]003309197.8292[null]Q13[null][null]
8331Olsen, Master. Artur Karlmale9.001C 173683.1708[null]S13[null][null]
8430Olsen, Mr. Henry Margidomale28.000C 400122.525[null]S[null]173[null]
8530Olsen, Mr. Karl Siegwart Andreasmale42.00145798.4042[null]S[null][null][null]
8630Olsen, Mr. Ole Martinmale[null]00Fa 2653027.3125[null]S[null][null][null]
8730Olsson, Miss. Elinafemale31.0003504077.8542[null]S[null][null][null]
8830Olsson, Mr. Nils Johan Goranssonmale28.0003474647.8542[null]S[null][null][null]
8931Olsson, Mr. Oscar Wilhelmmale32.0003470797.775[null]SA[null][null]
9030Olsvigen, Mr. Thor Andersonmale20.00065639.225[null]S[null]89Oslo, Norway Cameron, WI
9130Oreskovic, Miss. Jelkafemale23.0003150858.6625[null]S[null][null][null]
9230Oreskovic, Miss. Marijafemale20.0003150968.6625[null]S[null][null][null]
9330Oreskovic, Mr. Lukamale20.0003150948.6625[null]S[null][null][null]
9430Osen, Mr. Olaf Elonmale16.00075349.2167[null]S[null][null][null]
9531Osman, Mrs. Marafemale31.0003492448.6833[null]S[null][null][null]
9630O'Sullivan, Miss. Bridget Maryfemale[null]003309097.6292[null]Q[null][null][null]
9730Palsson, Master. Gosta Leonardmale2.03134990921.075[null]S[null]4[null]
9830Palsson, Master. Paul Folkemale6.03134990921.075[null]S[null][null][null]
9930Palsson, Miss. Stina Violafemale3.03134990921.075[null]S[null][null][null]
10030Palsson, Miss. Torborg Danirafemale8.03134990921.075[null]S[null][null][null]
Rows: 1-100 | Columns: 14

Note

vastorbit offers a wide range of sample datasets that are ideal for training and testing purposes. You can explore the full list of available datasets in the Datasets, which provides detailed information on each dataset and how to use them effectively. These datasets are invaluable resources for honing your data analysis and machine learning skills within the vastorbit environment.

Function Application

First we import the balance function:

from vastorbit.machine_learning.vast import balance

Then we can directly apply it to the dataset:

balance(
    name = "balance_model",
    input_relation = data,
    y = "survived",
    method = "under",
)
123
pclass
Integer
123
survived
Integer
Abc
name
Varchar(164)
Abc
sex
Varchar(20)
123
age
Double
123
sibsp
Integer
123
parch
Integer
Abc
ticket
Varchar(36)
123
fare
Double
Abc
cabin
Varchar(30)
Abc
embarked
Varchar(20)
Abc
boat
Varchar(100)
123
body
Integer
Abc
home.dest
Varchar(100)
121del Carlo, Mrs. Sebastiano (Argenia Genovesi)female24.010SC/PARIS 216727.7208[null]C12[null]Lucca, Italy / California
231Abelseth, Mr. Olaus Jorgensenmale25.0003481227.65F G63SA[null]Perkins County, SD
311Chambers, Mr. Norman Campbellmale27.01011380653.1E8S5[null]New York, NY / Ithaca, NY
431McCoy, Miss. Aliciafemale[null]2036722623.25[null]Q16[null][null]
531Jansson, Mr. Carl Olofmale21.0003500347.7958[null]SA[null][null]
631Moussa, Mrs. (Mantoura Boulos)female[null]0026267.2292[null]C[null][null][null]
731Pickard, Mr. Berk (Berk Trembisky)male32.000SOTON/O.Q. 3920788.05E10S9[null][null]
831Olsen, Master. Artur Karlmale9.001C 173683.1708[null]S13[null][null]
931Backstrom, Mrs. Karl Alfred (Maria Mathilda Gustafsson)female33.030310127815.85[null]S[null][null]Ruotsinphytaa, Finland New York, NY
1031Moran, Miss. Berthafemale[null]1037111024.15[null]Q16[null][null]
1111Harder, Mrs. George Achilles (Dorothy Annan)female25.0101176555.4417E50C5[null]Brooklyn, NY
1231Daly, Mr. Eugene Patrickmale29.0003826517.75[null]Q13 15 B[null]Co Athlone, Ireland New York, NY
1331Sjoblom, Miss. Anna Sofiafemale18.00031012657.4958[null]S16[null][null]
1411Candee, Mrs. Edward (Helen Churchill Hungerford)female53.000PC 1760627.4458[null]C6[null]Washington, DC
1531Baclini, Miss. Marie Catherinefemale5.021266619.2583[null]CC[null]Syria New York, NY
1611Lesurer, Mr. Gustave Jmale35.000PC 17755512.3292B101C3[null][null]
1711Crosby, Mrs. Edward Gifford (Catherine Elizabeth Halstead)female64.01111290126.55B26S7[null]Milwaukee, WI
1821Smith, Miss. Marion Elsiefemale40.0003141813.0[null]S9[null][null]
1921Jacobsohn, Mrs. Sidney Samuel (Amy Frances Christy)female24.02124384727.0[null]S12[null]London
2031Duquemin, Mr. Josephmale24.000S.O./P.P. 7527.55[null]SD[null]England Albion, NY
2111Hawksford, Mr. Walter Jamesmale[null]001698830.0D45S3[null]Kingston, Surrey
2231Thomas, Master. Assad Alexandermale0.420126258.5167[null]C16[null][null]
2311Fortune, Miss. Alice Elizabethfemale24.03219950263.0C23 C25 C27S10[null]Winnipeg, MB
2411Fleming, Miss. Margaretfemale[null]0017421110.8833[null]C4[null][null]
2511Anderson, Mr. Harrymale48.0001995226.55E12S3[null]New York, NY
2631Barah, Mr. Hanna Assimale20.00026637.2292[null]C15[null][null]
2731Gilnagh, Miss. Katherine "Katie"female16.000358517.7333[null]Q16[null]Co Longford, Ireland New York, NY
2811Gibson, Miss. Dorothy Winifredfemale22.00111237859.4[null]C7[null]New York, NY
2911Frauenthal, Mr. Isaac Geraldmale43.0101776527.7208D40C5[null]New York, NY
3021Williams, Mr. Charles Eugenemale[null]0024437313.0[null]S14[null]Harrow, England
3121Abelson, Mrs. Samuel (Hannah Wizosky)female28.010P/PP 338124.0[null]C10[null]Russia New York, NY
3231Murphy, Miss. Katherine "Kate"female[null]1036723015.5[null]Q16[null][null]
3311Davidson, Mrs. Thornton (Orian Hays)female27.012F.C. 1275052.0B71S3[null]Montreal, PQ
3411Barkworth, Mr. Algernon Henry Wilsonmale80.0002704230.0A23SB[null]Hessle, Yorks
3531Andersen-Jensen, Miss. Carla Christine Nielsinefemale19.0103500467.8542[null]S16[null][null]
3611Thayer, Mrs. John Borland (Marian Longstreth Morris)female39.01117421110.8833C68C4[null]Haverford, PA
3731Aks, Mrs. Sam (Leah Rosen)female18.0013920919.35[null]S13[null]London, England Norfolk, VA
3821Shelley, Mrs. William (Imanita Parrish Hall)female25.00123043326.0[null]S12[null]Deer Lodge, MT
3921Mallet, Mrs. Albert (Antoinette Magnin)female24.011S.C./PARIS 207937.0042[null]C10[null]Paris / Montreal, PQ
4021Ridsdale, Miss. Lucyfemale50.000W./C. 1425810.5[null]S13[null]London, England / Marietta, Ohio and Milwaukee, WI
4111Crosby, Miss. Harriet Rfemale36.002WE/P 573571.0B22S7[null]Milwaukee, WI
4211Carter, Mr. William Ernestmale36.012113760120.0B96 B98SC[null]Bryn Mawr, PA
4321Silven, Miss. Lyyli Karoliinafemale18.00225065213.0[null]S16[null]Finland / Minneapolis, MN
4421Hart, Miss. Eva Miriamfemale7.002F.C.C. 1352926.25[null]S14[null]Ilford, Essex / Winnipeg, MB
4531McGowan, Miss. Anna "Annie"female15.0003309238.0292[null]Q[null][null][null]
4611Carter, Miss. Lucile Polkfemale14.012113760120.0B96 B98S4[null]Bryn Mawr, PA
4731Peter, Miss. Annafemale[null]11266822.3583F E69CD[null][null]
4821Harper, Miss. Annie Jessie "Nina"female6.00124872733.0[null]S11[null]Denmark Hill, Surrey / Chicago
4911Fortune, Miss. Mabel Helenfemale23.03219950263.0C23 C25 C27S10[null]Winnipeg, MB
5011Lindstrom, Mrs. Carl Johan (Sigrid Posse)female55.00011237727.7208[null]C6[null]Stockholm, Sweden
5121Drew, Master. Marshall Brinesmale8.0022822032.5[null]S10[null]Greenport, NY
5211Cleaver, Miss. Alicefemale22.000113781151.55[null]S11[null][null]
5311Ryerson, Miss. Susan Parker "Suzette"female21.022PC 17608262.375B57 B59 B63 B66C4[null]Haverford, PA / Cooperstown, NY
5421Cook, Mrs. (Selena Rogers)female22.000W./C. 1426610.5F33S14[null]Pennsylvania
5511Frauenthal, Mrs. Henry William (Clara Heinsheimer)female[null]10PC 17611133.65[null]S5[null]New York, NY
5611Thorne, Mrs. Gertrude Maybellefemale[null]00PC 1758579.2[null]CD[null]New York, NY
5731McCoy, Miss. Agnesfemale[null]2036722623.25[null]Q16[null][null]
5811Icard, Miss. Ameliefemale38.00011357280.0B28[null]6[null][null]
5931Jalsevac, Mr. Ivanmale29.0003492407.8958[null]C15[null][null]
6021Duran y More, Miss. Florentinafemale30.010SC/PARIS 214813.8583[null]C12[null]Barcelona, Spain / Havana, Cuba
6121Richards, Master. George Sibleymale0.83112910618.75[null]S4[null]Cornwall / Akron, OH
6231Mannion, Miss. Margarethfemale[null]00368667.7375[null]Q16[null][null]
6321Ball, Mrs. (Ada E Hall)female36.0002855113.0DS10[null]Bristol, Avon / Jacksonville, FL
6411Stengel, Mr. Charles Emil Henrymale54.0101177855.4417C116C1[null]Newark, NJ
6511Futrelle, Mrs. Jacques Heath (Lily May Peel)female35.01011380353.1C123SD[null]Scituate, MA
6611Willard, Miss. Constancefemale21.00011379526.55[null]S8 10[null]Duluth, MN
6731Turkula, Mrs. (Hedwig)female63.00041349.5875[null]S15[null][null]
6811Behr, Mr. Karl Howellmale26.00011136930.0C148C5[null]New York, NY
6911Goldenberg, Mr. Samuel Lmale49.0101745389.1042C92C5[null]Paris, France / New York, NY
7031Honkanen, Miss. Eliinafemale27.000STON/O2. 31012837.925[null]S[null][null][null]
7111Carter, Master. William Thornton IImale11.012113760120.0B96 B98S4[null]Bryn Mawr, PA
7221Laroche, Miss. Simonne Marie Anne Andreefemale3.012SC/Paris 212341.5792[null]C14[null]Paris / Haiti
7331Madsen, Mr. Fridtjof Arnemale24.000C 173697.1417[null]S13[null][null]
7431Karlsson, Mr. Einar Gervasiusmale21.0003500537.7958[null]S13[null][null]
7521Collett, Mr. Sidney C Stuartmale24.0002803410.5[null]S9[null]London / Fort Byron, NY
7631O'Leary, Miss. Hanora "Norah"female[null]003309197.8292[null]Q13[null][null]
7721Davies, Master. John Morgan Jrmale8.011C.A. 3311236.75[null]S14[null]St Ives, Cornwall / Hancock, MI
7821Wright, Miss. Marionfemale26.00022084413.5[null]S9[null]Yoevil, England / Cottage Grove, OR
7911Hippach, Mrs. Louis Albert (Ida Sophia Fischer)female44.00111136157.9792B18C4[null]Chicago, IL
8031Abelseth, Miss. Karen Mariefemale16.0003481257.65[null]S16[null]Norway Los Angeles, CA
8111Wick, Miss. Mary Nataliefemale31.00236928164.8667C7S8[null]Youngstown, OH
8221Pallas y Castello, Mr. Emiliomale29.000SC/PARIS 214713.8583[null]C9[null]Spain / Havana, Cuba
8331Assaf Khalil, Mrs. Mariana ("Miriam")female45.00026967.225[null]CC[null]Ottawa, ON
8431Hellstrom, Miss. Hilda Mariafemale22.00075488.9625[null]SC[null][null]
8531Hirvonen, Mrs. Alexander (Helga E Lindqvist)female22.011310129812.2875[null]S15[null][null]
8631Olsson, Mr. Oscar Wilhelmmale32.0003470797.775[null]SA[null][null]
8721Doling, Miss. Elsiefemale18.00123191923.0[null]S[null][null]Southampton
8831Johnson, Mrs. Oscar W (Elisabeth Vilhelmina Berg)female27.00234774211.1333[null]S15[null][null]
8931Andersson, Miss. Erna Alexandrafemale17.04231012817.925[null]SD[null]Ruotsinphyhtaa, Finland New York, NY
9011Bowerman, Miss. Elsie Edithfemale22.00111350555.0E33S6[null]St Leonards-on-Sea, England Ohio
9111Shutes, Miss. Elizabeth Wfemale40.000PC 17582153.4625C125S3[null]New York, NY / Greenwich CT
9211Bonnell, Miss. Carolinefemale30.00036928164.8667C7S8[null]Youngstown, OH
9331McCoy, Mr. Bernardmale[null]2036722623.25[null]Q16[null][null]
9411Minahan, Miss. Daisy Efemale33.0101992890.0C78Q14[null]Green Bay, WI
9531Bradley, Miss. Bridget Deliafemale22.0003349147.725[null]Q13[null]Kingwilliamstown, Co Cork, Ireland Glens Falls, NY
9621Nye, Mrs. (Elizabeth Ramell)female29.000C.A. 2939510.5F33S11[null]Folkstone, Kent / New York, NY
9711Mock, Mr. Philipp Edmundmale30.0101323657.75C78C11[null]New York, NY
9831Madigan, Miss. Margaret "Maggie"female[null]003703707.75[null]Q15[null][null]
9921Mallet, Master. Andremale1.002S.C./PARIS 207937.0042[null]C10[null]Paris / Montreal, PQ
10031McCormack, Mr. Thomas Josephmale[null]003672287.75[null]Q[null][null][null]
Rows: 1-100 | Columns: 14

See also

VastFrame.sample() : Sampling the dataset.