PYECM(1)

✨ PYECM(1) ✨

okay bestie, welcome to the pyecm manual — section 1 of the General Commands Manual, the one you read when you're tryna factor numbers and the numbers are being <em>a lot</em>. 🎀 let's get into it 💅

🌸 NAME 🌸

pyecm — number factorization with the Elliptic Curve Method. she factors. she's an icon. that's the whole job. 🦋

🌈 SYNOPSIS 🌈

pyecm [OPTIONS] [FACTORS]...

like. that's it. that's the shape of her. ✨

💖 DESCRIPTION 💖

so pyecm factors numbers using the Elliptic Curve Method (ECM). if you hand her some FACTORS, she'll factor each and every one of them, one by one, no complaints. if you don't hand her anything? she reads from standard input instead, like a chill girl who's fine either way. 🫶

and ooh — you can type "exit" at any time to quit pyecm. literally any time. she's not clingy. 💜

🎀 the flags, bestie 🎀

• -h, --help — get help using pyecm. she'll tell you what's up. 🙈
• --portion=num — does only part of the work for factoring, corresponding to what fraction of the total work the machine is doing. this is the parallel-girlie flag. say you've got three machines: 1GHz, 1GHz, and 2GHz — then you'd set this to 0.25 for the two 1GHz machines and 0.5 for the 2GHz machine. it implies -r and -v, and there's a reason for that: -r is needed to avoid duplicating work and -v is needed to report results. no notes. 🔥
• --ov=num — sets the value of the internal parameter ov, which determines the trade-off between memory and time usage. > ⚠️ do not touch this if you do not know what you are doing. please read all the documentation and understand the full implications of the parameter before using this switch. i'm serious bestie, this is the "trust me you don't want to" flag. 💀
• -n, --noverbose — terse. on by default, lowkey. needed to cancel the -v from the --portion or --random switches. if both -n and -v are specified, the one specified last takes precedence. last one in the group chat wins, periodt. 👑
• -r, --random — chooses random values for sigma, an internal parameter in the calculation. implies -v, because honestly? if you're doing something random, you want to know what's happening. correct. valid. iconic. 🌈
• -v, --verbose — explains what is being done with intermediate calculations and results. she'll narrate. main character energy fr fr. 💅

⭐ EXAMPLES ⭐

pyecm 2^3-1 1000 "(3^13+2)*5"

factor 7, 1000, then 7971625. look at her go. ate. 🍓

pyecm

get factors from standard input. just vibes, just numbers. ✨

🦋 AUTHOR 🦋

written by Eric Larson and Martin Kelly. kings. 👑

😭 REPORTING BUGS 😭

please send bugs to Eric Larson <elarson3@uoregon.edu>. be nice about it, he's doing his best. 🫶

and that's the whole page, bestie — you just read pyecm version 2.0.2 of the PYECM(1) manual. go factor something cute. bye bestie 💖✨🎀