[−][src]Crate ca_rules
Parsing rule strings of life-like and other cellular automata.
Currently the following rules are supported:
- Totalistic Life-like,
e.g.,
B3/S23
. - Isotropic non-totalistic Life-like,
e.g.,
B2ci3ai4c8/S02ae3eijkq4iz5ar6i7e
. - Non-isotropic Life-like,
e.g.,
MAPARYXfhZofugWaH7oaIDogBZofuhogOiAaIDogIAAgAAWaH7oaIDogGiA6ICAAIAAaIDogIAAgACAAIAAAAAAAA
. - Totalistic Hexagonal,
e.g.,
B2/S34H
. - Isotropic non-totalistic Hexagonal,
e.g.,
B2o3-o4m/S12m3o4m5H
. - Non-isotropic Hexagonal,
e.g.,
MAPFgFoF2gXgH5oF4B+gH4A6AH
. - von Neumann neighborhood,
e.g.,
B2/S013V
. - Non-isotropic von Neumann,
e.g.,
MAPHmlphg
. - The corresponding Generations rules
of the above rules, e.g.,
3457/357/5
.
For non-Generations rules, four different notations are supported:
- B/S notation (
B3/S23
) - S/B notation (
23/3
) - MAP strings
for non-isotropic rules
(
MAPARYXfhZofugWaH7oaIDogBZofuhogOiAaIDogIAAgAAWaH7oaIDogGiA6ICAAIAAaIDogIAAgACAAIAAAAAAAA
)
For Generations rules, four different notations are supported:
- B/S notation (
B357/S3457/C5
) - The notation used by Golly (
3457/357/5
) - The notation used by Catagolue (
g5b357s3457
) - MAP strings
for non-isotropic rules
(
MAPARYBFxZpF38WaRd/aZZ//hZpF39pln/+aZZ//pZp/ukWaRd/aZZ//mmWf/6Waf7paZZ//pZp/umWaf7paZbplg/5
)
Please refer to Life Wiki for detailed definitions and notations of these rule strings.
Example:
use ca_rules::ParseLife; // Define a struct for your rule: #[derive(Debug, Eq, PartialEq)] struct Rule { b: Vec<u8>, s: Vec<u8>, } // Implement a parser trait for your rule: // The choice of the trait depends on the type of rules you want to parse. impl ParseLife for Rule { // Implement a function to construct the rule from b and s data: fn from_bs(b: Vec<u8>, s: Vec<u8>) -> Self { Rule { b, s } } } // Then you can parse a rule string: let life = Rule::parse_rule("B3/S23").unwrap(); assert_eq!( life, Rule { b: vec![3], s: vec![2, 3], } )
Enums
ParseRuleError | Errors that can be returned when parsing rule strings. |