{smcl}
{* *! version 1.0  22sept2009}{...}
{cmd:help simuladip} {right: version 1.0}
{hline}

{title:Title}

{p 8 14 2}
{hi:simuladip} {hline 2} Simula el porcentaje de votos recibido por los partidos pol{c i'}ticos en un sistema electoral multipartista.


{title:Syntax}

{p 8 14 2}
{cmdab:simula:dip}
{helpb using}
{it: filename}
[{cmd:,}
{it:options}]


{synoptset 22 tabbed}{...}
{synopthdr:options}
{synoptline}
{p2coldent:* {opt gen:erate(newvarlist)}}nombre de las (nuevas) variables con los porcentajes simulados
{p_end}
{synopt:{opt genb:ase(newvar)}}nombre de la (nueva) variable con las simulaciones del porcentaje del partido usado como base en la transformaci{c o'}n log{c i'}stica multivariada (v{c e'}ase {helpb estimadip})
{p_end}
{synopt:{opt set(option_list)}}indica los valores de las variables independientes que se deben utilizar para el c{c a'}lculo de las simulaciones
{p_end}
{synopt:{opt replace}}reemplazar {it:filename}, 
si actualmente existe
{p_end}
{synopt:{opt ev}}instruye a {cmd: simuladip} a calcular valores esperados en lugar de valores predichos
{p_end}
{synoptline}
{p2colreset}{...}
{p 4 6 2}
* {opt generate()} es una opci{c o'}n obligatoria.
{p_end}


{title:Description}

{pstd}
Para cada distrito electoral,
{cmd:simuladip} simula los valores esperados o predichos del porcentaje de votos recibido por los partidos pol{c i'}ticos en un sistema electoral multipartista.
Para el c{c a'}lculo de dichos valores, 
{cmd:simuladip} utiliza los par{c a'}metros simulados por {helpb estimadip}. 
El algoritmo aplica la transformaci{c o'}n log{c i'}stica inversa a las simulaciones (que originalmente est{c a'}n expresadas en logaritmos de razones), 
y luego calcula determin{c i'}sticamente el porcentaje de votos del partido utilizado como base en la transformaci{c o'}n log{c i'}stica multivariada.
{cmd:simuladip} genera la base de datos {it: filename} que contiene las siguientes variables: 
(1) un identificador de las simulaciones, 
(2) un identificador del distrito que es igual al n{c u'}mero de observaci{c o'}n {bf: _n} (v{c e'}ase {helpb _variables}) en la base de datos del usuario, 
(3) las simulaciones del porcentaje de votos de los partidos utilizados como variables dependientes en {helpb estimadip}, 
y (4) las simulaciones del porcentaje de votos del partido empleado como base en la transformaci{c o'}n log{c i'}stica multivariada.

{pstd}
{cmd:estimadip} utiliza algunos macros del m{c o'}dulo {stata "net from http://gking.harvard.edu/clarify/":{it:Clarify}}.


{title:Options}

{dlgtab:Main}

{phang}
{opt generate(newvarlist)} indica los nombres de las (nuevas) variables con los porcentajes simulados.
El n{c u'}mero de variables en {it:newvarlist} debe ser igual al n{c u'}mero de variables dependientes en {helpb estimadip}.
El primer nombre en {it: newvarlist} contendr{c a'} los porcentajes simulados del partido asociado a la variable dependiente de la primera ecuaci{c o'}n en {helpb estimadip}; 
el segundo nombre contendr{c a'} las simulaciones del partido asociado a la variable dependiente de la segunda ecuaci{c o'}n, 
y as{c i'} sucesivamente.

{phang}
{opt genbase(newvar)} indica el nombre de la (nueva) variable con los porcentajes simulados del partido que se emple{c o'} como base en la transformaci{c o'}n log{c i'}stica multivariada (v{c e'}ase {helpb estimadip}).
Por default, {opt genbase(party_J)}

{phang}
{opt set(option_list)} indica los valores de las variables independientes que se deben utilizar para el c{c a'}lculo de las simulaciones. 
Para cada distrito (observaci{c o'}n) utilizada en {helpb estimadip}, 
{cmd: simuladip} traza {it:T} simulaciones fijando las variables independientes en sus valores reales, 
{it:excepto} las que se especifican en {opt set()}.
Si la opci{c o'}n {cmd: set()} no se especifica, 
{cmd: simuladip} fija todas las variables independientes en sus valores reales.

{p 8 8 2}
{it: option_list} tiene la siguiente estructura:

{p 12 12 2}
{varlist} {it:rule}
[{it:rule}{it:...}]
{ifin}
[{cmd: ,}
{varlist} {it:rule}
[{it:rule}{it:...}] ]

{p 8 8 2}
donde {it: rule} hace referencia a la sintaxis del comando {helpb recode}. 
Para el correcto funcionamiento de {cmd: simuladip}, 
las reglas que deben aplicarse son las siguientes (si se utilizan otras reglas, 
es responsabilidad del usuario verificar que el procedimiento funciona de la manera deseada):

{col 12}{c TLC}{hline 16}{col 28}{c TT}{hline 13}{col 41}{c TT}{hline 29}{col 73}{c TRC}
{col 12}{c |}{it: rule}{col 29}{c |} Ejemplo{col 43}{c |} Significado{col 73}{c |}
{col 12}{c LT}{hline 16}{col 28}{c +}{hline 13}{col 41}{c +}{hline 29}{col 73}{c RT}
{col 12}{c |} {it:#} {cmd:=} {it:#}{col 29}{c |} 3 = 1{col 43}{c |} cambia 3 a 1{col 73}{c |}
{col 12}{c |} {it:#} {it:#} {cmd:=} {it:#}{col 29}{c |} 2 5 = 9{col 43}{c |} cambia 2 y 5 a 9{col 73}{c |}
{col 12}{c |} {it:#}{cmd:/}{it:#} {cmd:=} {it:#}{col 29}{c |} 1/5 = 4{col 43}{c |} cambia del 1 al 5 a 4{col 73}{c |}
{col 12}{c |} {opt nonm:issing} {cmd:=} {it:#}{col 29}{c |} nonmiss = 8{col 43}{c |} todos los dem{c a'}s valores a 8{col 73}{c |}
{col 12}{c BLC}{hline 16}{col 28}{c BT}{hline 13}{col 41}{c BT}{hline 29}{col 73}{c BRC}

{p 8 8 2}Si de desea aplicar la(s) misma(s) regla(s) a m{c a'}s de dos variables, 
{it:rule} debe aparecer entre par{c e'}ntesis. 
Por ejemplo, 

{p 12}{cmd: set( x y 0=1 )} 

{p 8 8 2}generar{c a'} un error; 
en su lugar debe especificarse 

{p 12}{cmd: set( x z (0=1) )} 

{p 8 8 2}que es equivalente a {cmd: set(x 0=1, z 0=1)}.

{phang}
{opt replace} reemplaza {it:filename}, 
si actualmente existe. 

{dlgtab:Advanced}

{phang}
{opt ev} instruye a {cmd: simuladip} a calcular valores esperados; 
por default, 
{cmd: simuladip} calcula valores predichos.

{title:Remarks}

{pstd}
{cmd: simuladip} genera el archivo {it: filename}.
La estructura de {it: filename} es similar a la que se muestra a continuaci{c o'}n:


{center:{cmd:_IDsim   _IDdto   party1    party2    party3    party_J}}
{center:{hline 55}}
{center:   1        1      .25       .25       .25        .25 }
{center:   1        2      .10       .20       .40        .30 }
{center:   1        3      .20       .20       .30        .30 }
{center:   2        1      .25       .25       .25        .25 }
{center:   2        2      .10       .20       .40        .30 }
{center:   2        3      .20       .20       .30        .30 }
{center:   3        1      .25       .25       .25        .25 }
{center:   3        2      .10       .20       .40        .30 }
{center:   3        3      .20       .20       .30        .30 }

{pstd}
{it: filename} puede utilizarse para extraer cantidades de inter{c e'}s relacionadas con curules a trav{c e'}s de {helpb asignadip}.


{title:Examples}

{p 8 10 2}{cmd:. simuladip using mydata, gen(sim_y1 sim_y2 sim_y3) replace}

{p 8 10 2}{cmd:. simuladip using mydata, gen(simpan simpri simprd simna) genb(simasdc)}

{p 8 10 2}{cmd:. simuladip using mydata, gen(sim_y1 sim_y2 sim_y3) set(x 0=1)}

{p 8 10 2}{cmd:. simuladip using mydata, gen(sim_y1 sim_y2 sim_y3) set(x 0 1=2)}

{p 8 10 2}{cmd:. simuladip using mydata, gen(sim_y1 sim_y2 sim_y3) set(x 0/5=0)}

{p 8 10 2}{cmd:. simuladip using mydata, gen(sim_y1 sim_y2 sim_y3) set(x 0=1, z 1=0)}

{p 8 10 2}{cmd:. simuladip using mydata, gen(sim_y1 sim_y2 sim_y3) set(x z (0=1))}

{p 8 10 2}{cmd:. simuladip using mydata, gen(sim_y1 sim_y2 sim_y3) set(x z (0=1), w 2=1)}

{p 8 10 2}{cmd:. simuladip using mydata, gen(simpan simpri simprd simna) set(x z (0=1), w p (2=1))}


{title:Authors}

{phang}
Javier Aparicio, 
Centro de Investigaci{c o'}n y Docencia Econ{c o'}micas, 
CIDE.
javier.aparicio@cide.edu

{phang}
Javier M{c a'}rquez,
Buend{c i'}a & Laredo.
javier.marquez@buendiaylaredo.com


{title:Reference}

{pstd}
{cmd: simuladip} es parte del paquete {cmd: camaradip}: 
M{c o'}dulo de Stata para elaborar contrafactuales de la C{c a'}mara de Diputados con simulaciones de Monte Carlo.
Si utiliza {cmd: simuladip}, 
por favor cite las siguientes referencias:

{phang}
M{c a'}rquez, Javier y Javier Aparicio (2010), Un modelo Monte Carlo para la C{c a'}mara de Diputados en M{c e'}xico, Pol’tica y Gobierno, vol. XVII, n{c u'}m 2.

{phang}
---- (2009), {cmd: camaradip}: M{c o'}dulo de Stata para elaborar contrafactuales de la C{c a'}mara de Diputados con simulaciones de Monte Carlo.


{title:Also see}

{pstd}
Online: {helpb estimadip}, {helpb asignadip}, {helpb recode}.