Nutricard                package:unknown                R Documentation

Cardapio aleatório condicionado às necessidades do usuario

Description:

     A função escolhe ao acaso alimentos que juntos satisfazem a necessidade do usuario quanto 
     a maximização de um nutriente desejado e de um nutriente que aumenta a absorção (biodisponibilidade) do nutriente      
     desejado. Como produto final é gerado um cardápio com refeições, tendo o usuario a opção de escolher: a quantidade de refeições desejada ( 
     cada uma contendo 5 grupos de alimentos específicos), a quantidade de itens para cada grupo de alimento 
     e a quantidade de calorias que nao deve ser ultrapassada por refeição.     


Usage:

     Nutricard (Nutri, Nutripar, alimento1, alimento2, alimento3, alimento4, alimento5,
     Nutriposi, Nutriparposi, Size1, Size2, Size3, Size4, Size5, Kcalposi, Kcal, N)

Arguments:

 Nutri: Vetor numérico e maior que zero com os valores do nutriente desejado do conjunto de dados completo.

 Nutripar: Vetor numérico e maior que zero com os valores do nutriente que forma par com o nutriente desejado e aumenta sua biodisponibilidade. 

 alimento1: Dataframe contendo um subset de alimentos (tirado do conjunto de dados completo) que pertencem a um grupo específico (ex:legume,fruta…) contendo Nutri, Nutripar, as quilocalorias de cada alimento e o restante de nutrientes de cada alimento com seus valores.

 alimento2: Dataframe contendo um subset de alimentos (tirado do conjunto de dados completo) que pertencem a um grupo específico (ex:legume,fruta…) contendo Nutri, Nutripar, as quilocalorias de cada alimento e o restante de nutrientes de cada alimento com seus valores.

 alimento3: Dataframe contendo um subset de alimentos (tirado do conjunto de dados completo) que pertencem a um grupo específico (ex:legume,fruta…) contendo Nutri, Nutripar, as quilocalorias de cada alimento e o restante de nutrientes de cada alimento com seus valores.

 alimento4: Dataframe contendo um subset de alimentos (tirado do conjunto de dados completo) que pertencem a um grupo específico (ex:legume,fruta…) contendo Nutri, Nutripar, as quilocalorias de cada alimento e o restante de nutrientes de cada alimento com seus valores.

 alimento5: Dataframe contendo um subset de alimentos (tirado do conjunto de dados completo) que pertencem a um grupo específico (ex:legume,fruta…) contendo Nutri, Nutripar, as quilocalorias de cada alimento e o restante de nutrientes de cada alimento com seus valores.

 Nutriposi: Numero inteiro e maior que zero que indica a posicão da coluna do nutriente desejado (Nutri).

 Nutriparposi: Numero inteiro e maior que zero que indica a posição da coluna do nutriente par do desejado (Nutripar).

 Size1: Numero inteiro e maior que zero que indica a quantidade de itens em alimento1 a serem selecionados.

 Size2: Numero inteiro e maior que zero que indica a quantidade de itens em alimento2 a serem selecionados.

 Size3: Numero inteiro e maior que zero que indica a quantidade de itens em alimento3 a serem selecionados.

 Size4: Numero inteiro e maior que zero que indica a quantidade de itens em alimento4 a serem selecionados.

 Size5: Numero inteiro e maior que zero que indica a quantidade de itens em alimento5 a serem selecionados. 

 Kcalposi: Numero inteiro e maior que zero que indica a posição da coluna referente as calorias.

 Kcal: Valor numérico e maior que zero que indica a quantidade de caloria que não deve ser ultrapassada por refeição.

 N: Valor inteiro e maior que zero que indica a quantidade desejada de refeições. 



Value:

     Lista contendo dataframes em que a quantidade de dataframes é determinada pelo argumento "N", sendo que cada dataframe representa uma refeição individual:

  comp1: Dataframe que contém os itens alimentares selecionados aleatóriamente, o grupo a qual cada um pertence, e os valores de: nutriente desejado e nutriente par do desejado para cada item alimentar (sendo que a soma do nutriente desejado e nutriente par do desejado dos itens alimentares são maiores que a média do nutriente 
desejado e do nutriente par do desejado presente no conjunto de dados completo, respectivamente),
caloria (sendo que a soma de caloria de todos os itens alimentares por refeição não ultrapassa o valor de "Kcal" especifícada na função) e valores referentes aos restantes dos nutrientes para cada item alimentar. 

  comp2 : Dataframe que contém os itens alimentares selecionados aleatóriamente, o grupo a qual cada um pertence, e os valores de: nutriente desejado e nutriente par do desejado para cada item alimentar (sendo que a soma do nutriente desejado e nutriente par do desejado dos itens alimentares são maiores que a média do nutriente 
desejado e do nutriente par do desejado presente no conjunto de dados completo, respectivamente),
caloria (sendo que a soma de caloria de todos os itens alimentares por refeição não ultrapassa o valor de "Kcal" especifícada na função) e valores referentes aos restantes dos nutrientes para cada item alimentar. 

     ...

Warning:

     Caso algum argumento for inserido de forma incorreta ou estiver faltando, a função não executa.
    
     Dependendo dos grupos de alimentos específicados, a quantidade de itens para cada um e a quantidade de caloria ("Kcal") que não deve ser ultrapassada por      refeição, a função pode demorar alguns segundos para retornar o resultado. Caso o tempo de esperar seja 1 minuto ou mais, indica a impossibilidade da soma de caloria dos alimentos selecionados ser menor do que o argumento "Kcal", neste caso basta aumentar o valor de "Kcal" ou mudar o grupo ou a quantidade dos alimentos.   



Author(s):

     Rodrigo Silva do Carmo
     email: rodrigo.silva_19@usp.br

References:

   Aggett PJ. (2010). Population reference intakes and micronutrient bioavailability: a European perspective. American Journal of Clinical Nutrition 91(suppl):1433S-1437S.

  

Examples:

  Nutricard(Nutri=alimentacao$Iron,Nutripar=alimentacao$Vitamin.C,alimento1=alimentacao[
  alimentacao$food_group=="Fruits and Fruit Products", ],
  alimento2=alimentacao[alimentacao$food_group=="Vegetables and Vegetable Products", ],
  alimento3=alimentacao[alimentacao$food_group=="Beverages", ],
  alimento4=alimentacao[alimentacao$food_group=="Dairy and Egg Products", ],
  alimento5=alimentacao[alimentacao$food_group=="Cereal Grains and Pasta", ],
  Nutriposi=15,Nutriparposi=24,
  Size1=1,Size=2,Size3=1, Size4=1,Size5=1,Kcalposi= 7,Kcal=900.5,N=5)

  Nutricard(Nutri=alimentacao$Iron,Nutripar=alimentacao$Vitamin.C,alimento1=alimentacao[
  alimentacao$food_group=="Beef Products", ],
  alimento2=alimentacao[alimentacao$food_group=="Nut and Seed Products", ],
  alimento3=alimentacao[alimentacao$food_group=="Fruits and Fruit Juices", ],
  alimento4=alimentacao[alimentacao$food_group=="Legumes and Legume Products", ],
  alimento5=alimentacao[alimentacao$food_group=="Vegetables and Vegetable Products", ],
  Nutriposi=15,Nutriparposi=24,
  Size1=1,Size2=1,Size3=2, Size4=2,Size5=1,Kcalposi= 7,Kcal=1200,N=2)