Diamond brackets <> and square brackets [] notations

asked 2020-04-05 20:27:28 +0200

petRUShka
301 ●10 ●23 ●30

updated 2020-04-06 12:05:26 +0200

Are there some documentation on diamond bracket notation:

R.<w> = PolynomialRing(QQ)

and square bracket notation:

R.<y> = QQ['y'];

There is some documentation in Constructors for polynomial rings docs but it looks superficial on this topic.

Are there some complete explanation with all the details behind the scene?

Is it only for polynomial rings or for some other objects? Is it SageMath addition?

answered 2020-04-05 20:47:03 +0200

Sébastien
3153 ●5 ●39 ●85 http://www.slabbe.org/

updated 2020-04-05 20:53:54 +0200

Indeed, this is not Python syntax, it is SageMath syntax only. Sage preparses this notation and turns it into Python code:

sage: preparse('R.<w> = PolynomialRing(QQ)')
"R = PolynomialRing(QQ, names=('w',)); (w,) = R._first_ngens(1)"

Other examples include:

sage: preparse('2/3')
'Integer(2)/Integer(3)'
sage: preparse('2./3')
"RealNumber('2.')/Integer(3)"
sage: preparse('x^x')
'x**x'

Also, this turns off/on the preparser:

sage: preparser(False)
sage: preparser(True)

edit flag offensive delete link

Comments

Note that this does not exactly answers the question which started with "Are there some documentation ..."

vdelecroix ( 2020-04-05 21:16:35 +0200 )edit

The relevant documentation is for the function preparse_generators: http://doc.sagemath.org/html/en/refer.... There are more examples (labeled as "TESTS") which are in the code but not the reference manual.

John Palmieri ( 2020-04-05 22:34:01 +0200 )edit

Some documentation on that syntax can also be found in the section on A Guided tour on Polynomial of the Tutorial of SageMath at http://doc.sagemath.org/html/en/tutor... But it is true that some clearer documentation on this syntax could be explained on its own chapter somewhere.

Sébastien ( 2020-04-06 09:46:41 +0200 )edit

add a comment

Your Answer

Please start posting anonymously - your entry will be published after you log in or create a new account.

Diamond brackets <> and square brackets [] notations

1 Answer

Comments

Your Answer

Question Tools

Stats

Related questions

Diamond brackets <> and square brackets [] notations edit

1 Answer

Comments

Your Answer

Question Tools

Stats

Related questions

Diamond brackets <> and square brackets [] notations